用途:nextjs-i18n 用于在 Next.js 16 应用中实现国际化,通过 [locale] 动态段前缀路由或多语言字典管理,为多语言站点提供路由、导航、格式化与 SEO 支持。
主要能力:
- 路由:所有路由使用 [locale] 前缀(如 /en/about、/es/about),根路径重定向到默认语言。
- 两种方案:推荐使用 next-intl(支持 App Router 原生、类型安全消息、ICU MessageFormat、异步消息加载、proxy.ts 兼容、丰富格式化);或采用 DIY 字典,通过动态导入实现轻量翻译。
- 导航组件:提供本地化的 Link、redirect、usePathname、useRouter,自动处理语言前缀。
- 消息格式化:支持 ICU MessageFormat 的复数、性别 select 与富文本;提供 formatDate、formatNumber、formatList、formatRelativeTime 等格式化函数。
- SEO:支持 hreflang 备用链接和本地化元数据。
- RTL:通过 dir 属性支持从右到左语言。
- 错误处理:支持 [locale]/error.tsx、[locale]/not-found.tsx 和 global-error.tsx 的本地化。
使用方式:
- 推荐目录结构为 modules/cores/i18n/,包含 config(路由配置)、interfaces(TypeScript 类型)、services(请求处理与消息加载)、messages(各语言 JSON 文件)。
- 关键文件位置包括 src/modules/cores/i18n/src/config/routing.ts、messages/en.json、messages/es.json 以及 proxy.ts(语言检测与重定向)。
- 技能包含强制性的代理工作流:实施前并行调用三个代理(explore-codebase 分析现有 i18n 配置、research-expert 核实 next-intl 最新文档、查询 Context7 文档),实施后运行 sniper 验证。
- 参考文档涵盖安装、路由配置、中间件、翻译、格式化、服务端/客户端组件、导航、TypeScript、SEO、测试及 DIY 方案。
适用场景:构建多语言 Next.js 16 应用、需要基于语言的路由、实现语言切换与 URL 本地化、按语言格式化日期数字货币、通过 hreflang 优化 SEO、支持 RTL 语言。
限制:本技能专为 Next.js App Router 设计,不适用于无 Next.js 的纯 React 应用(参见 react-i18n)或 Astro 项目(参见 astro-i18n)。具体版本兼容性、依赖安装命令与配置细节需参考官方文档,资料中未提供完整安装命令与配置示例。