SaasOne v2.0 Docs
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 自动出现在语言下拉