国际化(i18n)
优先级:P2(中)
维护单一语言来源事实,并确保 SEO 友好的子路径路由。
实施指南
- 区域路由:遵循 URL-first 方法 以获得最佳 SEO。在 App Router 中使用 动态段(例如:
app/[lang]/page.tsx),并在next.config.js中使用i18n配置用于 Pages Router。 - 库选择:对于 App Router(现代化项目)使用
next-intl,对于旧版应用使用react-intl/next-translate。 - 检测:在
middleware.ts中实现 中间件本地化,通过Accept-Language头部或 cookie 检测用户语言并执行重定向。 - 服务端:在 服务端组件 中加载翻译
messages/*.json字典,以保持客户端包体积较小。使用getMessages()或requestConfig模式。 - SEO:确保在
metadataAPI 中为所有翻译路由正确生成hreflang标签。 - 静态生成:使用
generateStaticParams在构建时预渲染页面的本地化版本。module.exports = { i18n: { locales: ['en', 'fr', 'vi'], defaultLocale: 'en', }, };
3. 库特定设置
有关使用常见库的详细设置,请参考:
反模式
- 不要在 JSX 中硬编码字符串:使用翻译键;切勿提交原始文本。
- 不要使用客户端翻译包:在服务端使用
getMessages()加载字典。 - 不要混合 URL 区域模式:保持一致地使用子路径或域名。