20 语种支持
2026-11-21·5 分钟
多语言:20 语种路由
基于 next-intl 的高性能全球化路由拦截、无缝路径重写与动态字典按需加载机制。
支持的 20 种全球主要语言#
系统原生内置 20 种国际主流语种路由支持,包含:中文简体 (zh)、英语 (en)、繁体中文 (zh-TW)、日语 (ja)、韩语 (ko)、德语 (de)、法语 (fr)、西班牙语 (es)、葡萄牙语 (pt)、意大利语 (it)、俄语 (ru)、阿拉伯语 (ar)、印地语 (hi)、印尼语 (id)、泰语 (th)、越南语 (vi)、土耳其语 (tr)、荷兰语 (nl)、孟加拉语 (bn)、旁遮普语 (pa)。
路由策略与 localePrefix#
在 i18n/routing.ts 中,系统将默认语言设置为 en,并采用 localePrefix: as-needed 策略:
- 英文默认根路径为 /,无需多余的前缀。
- 其他语种如中文路径自动映射为 /zh/...、/ja/...。
- 导航时统一使用 @/i18n/navigation 导出的 <Link> 和 useRouter,组件无需关心当前语种前缀,由系统自动无缝处理。
服务端与客户端使用示例#
typescriptRSC 服务端组件提取文案
import { getTranslations } from 'next-intl/server';
export default async function PricingPage() {
const t = await getTranslations('pricing');
return <h1>{t('title')}</h1>;
}typescriptClient 客户端组件切换语种
import { useLocale } from 'next-intl';
import { useRouter, usePathname } from '@/i18n/navigation';
export function LanguageDropdown() {
const locale = useLocale();
const router = useRouter();
const pathname = usePathname();
function onSelect(nextLocale: string) {
router.replace(pathname, { locale: nextLocale });
}
}扩展一个新语种(两步)#
扩展新语种只需两步:在 locales 数组追加语言代码 + 新建对应字典文件,路由与语言切换器自动生效:
typescript新增一个语种(示例:加泰罗尼亚语 ca)
// 1. i18n/routing.ts —— 追加语言代码
export const routing = defineRouting({
locales: [
'en', 'zh', 'zh-TW', 'ja', 'ko', 'de', 'fr', 'es', 'pt', 'it',
'ru', 'ar', 'hi', 'id', 'th', 'vi', 'tr', 'nl', 'bn', 'pa',
'ca', // ← 新增
],
defaultLocale: 'en',
localePrefix: 'as-needed',
});
// 2. messages/ca.json —— 复制 en.json 翻译即可,UI 自动出现在语言下拉