SuperAPI AI 工具集

i18n

前端与建站

查看项目

更新于 10-16 03:06

技能介绍

用途:为 Next.js(App Router)项目添加完整国际化,基于 next-intl v4,覆盖路由、翻译文件、sitemap hreflang 与多语言批量翻译。要求 Next.js 13+ 且使用 App Router,并先确认项目是否已有部分 i18n 设置及需翻译的页面与硬编码文案。

主要能力:内置 14 种语言配置(en、es、fr、de、pt、ja、ar、zh、zh-tw、id、vi、ms、ru、hi),支持 RTL(ar);通过 localePrefix: 'as-needed' 让默认语言 URL 保持无前缀;提供 createNavigation 封装 Link、redirect、usePathname、useRouter;站点地图为每页生成一个 canonical URL 加 hreflang 备选链接。

使用方式:先安装 npm install next-intl;在 src/i18n/ 下创建 config.ts、routing.ts、navigation.ts、request.ts 四个配置文件;创建 src/middleware.ts 并排除 _next、api、sitemap、robots 等路径;用 createNextIntlPlugin 包装 next.config;将页面移入 src/app/[locale]/,layout 中调用 setRequestLocale 并设置 html lang 与 dir;把文案抽到 src/messages/en.json,用 useTranslations(客户端)或 getTranslations(服务端)替换硬编码文本;其余语言按同结构生成 {locale}.json,可用 codex-tasks 并行翻译。最后运行 npm run build 验证,并检查默认语言无前缀、其他语言有前缀、sitemap 含 hreflang、阿拉伯语 RTL 渲染。

限制与注意事项:localeDetection 设为 false 以避免基于浏览器语言自动跳转;public/sitemap.xml 与动态 sitemap.ts 在开发模式可能冲突,需删除或重命名静态文件;大翻译文件推送失败可调大 git http.postBuffer;机器翻译质量不稳定,需用英文残留检测脚本校验;构建页面数随语言数线性增长。相关资料未提供收费、价格或具体平台信息。