网站国际化
为 Next.js 网站添加多语言支持并遵循 SEO 最佳实践的完整工作流程。
何时使用此技能
- 为现有网站添加新的语言版本
- 为新网站设置 i18n(国际化)
- 为多语言配置 SEO
- 用户提及:“添加语言”、“翻译”、“本地化”、“hreflang”、“多语言”
支持的语言
常见目标市场:
- 🇺🇸 英语 (en) - 全球市场
- 🇯🇵 日语 (ja) - 亚洲市场
- 🇨🇳 中文 (zh) - 中国市场
支持的其他语言:
- 韩语 (ko)、葡萄牙语 (pt)、西班牙语 (es)、法语 (fr)、德语 (de)
- 阿拉伯语 (ar)、越南语 (vi)、印地语 (hi)、印尼语 (id)、泰语 (th)
- 繁体中文 (zh-hk)、意大利语 (it)、俄语 (ru)
国际化工作流程
复制此清单并跟踪进度:
i18n 进度:
- [ ] 步骤 1:准备基础语言文件
- [ ] 步骤 2:添加新的语言文件
- [ ] 步骤 3:更新配置文件
- [ ] 步骤 4:添加翻译
- [ ] 步骤 5:配置 SEO 元素
- [ ] 步骤 6:验证和测试
步骤 1:准备基础语言文件
确保 en.json 文件存在并作为模板:
必要的目录:
i18n/messages/en.json- 主要翻译i18n/pages/landing/en.json- 着陆页翻译
验证结构:
# 检查基础文件是否存在
ls i18n/messages/en.json
ls i18n/pages/landing/en.json
如果缺少,请为你的网站创建包含完整翻译键的相应文件。
步骤 2:添加新的语言文件
运行语言添加脚本:
node scripts/i18n-add-languages.mjs
脚本功能:
- 将
en.json复制到所有目标语言文件 - 更新
i18n/locale.ts以包含新的语言环境 - 更新
i18n/request.ts中的语言映射 - 更新
public/sitemap.xml以包含新语言 URL
脚本配置(在 i18n-add-languages.mjs 中):
languages数组 - 要添加的语言列表languageNames对象 - 语言的显示名称targetDirs数组 - 包含翻译文件的目录
请参阅 WORKFLOW.md 获取详细的分步指南。
步骤 3:验证配置更新
检查 i18n/locale.ts:
export const locales = ["en", "ja", "zh", "ko", ...];
export const localeNames: any = {
en: "English",
ja: "日本語",
zh: "中文",
ko: "한국어",
...
};
检查 i18n/request.ts:
- 配置了语言代码映射
- 存在
zh-CN→zh,zh-HK→zh-hk的映射
检查 public/sitemap.xml:
- 列出了所有语言版本
- 每个 URL 都包含
hreflang标签
步骤 4:添加翻译
选项 A:使用 AI 翻译(更快但需要复查):
# 添加结构化数据和定价翻译
node scripts/i18n-add-schema.js
在脚本的 translations 对象中配置翻译。
选项 B:手动翻译(推荐以保证质量):
使用正确的翻译编辑每个语言文件:
# 打开语言文件
code i18n/messages/ja.json
翻译最佳实践:
- 尽量使用母语者
- 在目标语言中保持 SEO 关键词
- 使内容适应当地文化,不要仅做直译
- 保持格式一致(占位符、变量)
请参阅 reference/locale-codes.md 了解语言代码参考。
步骤 5:配置 SEO 元素
hreflang 标签 - 通过站点地图自动生成,但需验证:
请参阅 reference/hreflang-guide.md 获取完整指南。
本地化元标签 - 在每个语言文件中翻译:
{
"metadata": {
"title": "您的网站标题",
"description": "您的 SEO 描述"
}
}
URL 结构 - 验证正确格式:
- 英语:
https://example.com/或https://example.com/en/ - 日语:
https://example.com/ja/ - 中文:
https://example.com/zh/
步骤 6:验证和测试
构建项目:
npm run build
关键:在继续之前修复所有错误。
手动测试:
-
语言切换器:
- 访问每个语言版本
- 验证语言切换器显示所有语言
- 点击每个语言链接,验证正确的页面加载
-
内容显示:
- 检查所有页面在每种语言中正确渲染
- 验证没有未翻译的文本(检查非英语页面中是否有英语内容)
- 测试特殊字符显示是否正确(日语、中文、阿拉伯语)
-
SEO 元素:
- 检查
<html lang="...">属性与页面语言匹配 - 验证存在
<link rel="alternate" hreflang="...">标签 - 检查元标签是否使用正确的语言
- 检查
自动验证:
# 检查站点地图
curl https://your-site.com/sitemap.xml | grep hreflang
# 验证 hreflang(使用在线工具)
# Google Search Console > 国际化 > hreflang
SEO 清单 - 请参阅 reference/seo-checklist.md。
如果验证失败:
- 仔细检查错误信息
- 检查配置文件中是否有拼写错误
- 验证语言代码是否正确
- 返回步骤 3 并修复问题
只有在所有验证通过后才能继续。
重要说明
语言代码标准
使用 ISO 639-1(双字母代码),可带有可选区域变体:
en- 英语ja- 日语zh- 简体中文zh-hk- 繁体中文(香港)pt- 葡萄牙语pt-br- 巴西葡萄牙语
请参阅 reference/locale-codes.md 获取完整列表。
SEO 影响
正确的 i18n 能改善 SEO,原因如下:
- 以用户母语定位目标用户
- 避免重复内容惩罚
- 帮助搜索引擎提供正确的语言版本
需要避免的常见 SEO 错误:
- ❌ 基于 IP 自动重定向(阻止搜索引擎抓取所有版本)
- ❌ 缺少 hreflang 标签(导致重复内容问题)
- ❌ 跨语言的 URL 结构不一致
- ❌ 未翻译的元标签
翻译质量
AI 翻译与人工翻译:
- ✅ AI:快速、经济高效,适合初稿
- ⚠️ AI:可能遗漏文化细微差别,需要复查
- ✅ 人工:质量更高,文化适应好
- ⚠️ 人工:较慢、成本较高
推荐方法:
- 使用 AI 生成初始翻译
- 请母语者审查和完善
- 与目标市场用户进行测试
- 根据反馈进行迭代
Next.js i18n 路由
系统使用 next-intl 进行路由:
- 从 URL 自动检测语言环境
- 语言切换器组件
- 本地化导航
配置位于 i18n/locale.ts 和 i18n/request.ts。
国际化后的任务
添加语言后:
- 提交更新后的站点地图到 Google Search Console
- 为每种语言/区域创建单独的 Search Console 属性
- 在 Analytics 中监控国际自然流量
- 如果不同语言的转化率不同,A/B 测试翻译
- 设置国际抓取错误的警报
脚本位置
所有 i18n 脚本都在 scripts/ 目录中:
i18n-add-languages.mjs- 添加新的语言文件i18n-add-schema.js- 添加结构化数据翻译
参考资料
- WORKFLOW.md - 详细的分步工作流程
- reference/hreflang-guide.md - hreflang 实施指南
- reference/locale-codes.md - 语言代码参考
- reference/seo-checklist.md - 国际 SEO 清单
如需故障排除,请参阅 WORKFLOW.md 的故障排除部分。