SuperAPI AI 工具集

nextjs-i18n

前端与建站

查看项目

更新于 10-26 16:21

技能介绍

用途: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)。具体版本兼容性、依赖安装命令与配置细节需参考官方文档,资料中未提供完整安装命令与配置示例。