Agent Skills
返回列表
💻

国际化与本地化

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/travisjneuman-claude-i18n-localization。

技能介绍

这技能解决什么问题

单语种产品里日期写成 MM/DD/YYYY、金额用 $ 前缀、错误文案硬编码在组件里,一到多市场就会踩格式、复数、RTL 排版和文化语境的坑。国际化(i18n)负责把界面与数据格式做成可按区域切换;本地化(l10n)则是把文案、数字、货币、图片与布局真正落到各语言环境。

技能如何帮你落地

这份指南按模块拆开了常见本地化面:文本(全量外置、ICU 消息格式、复数规则)、日期与时间(Intl、时区、相对时间,UTC 存、本地显)、数字与货币(Intl.NumberFormat / 货币实践)、RTL(dir、CSS 镜像布局)。实现侧覆盖 React(react-intl、翻译文件)与 Node.js(i18next、Express 中间件),并给出翻译工作流(目录结构、key 命名、协作方式)与 伪本地化、语言环境测试清单。

文档末尾有分阶段的 Checklist(初始搭建、按功能、上线前),以及明确的 DO / DON'T:例如不要拼接字符串做句子、不要手写复数分支、上线前要验证 hreflang 与 RTL 布局。

适用边界与注意点

技能偏重 Web 栈(JavaScript / React / Node)与工程流程,不会替你选翻译供应商,也不替代法务或品牌层面的文化审查。图片、颜色象征意义等仍需团队按目标市场单独评审;文本膨胀(常需预留 30%~50%)要在设计阶段就留好空间。

使用场景

  • 前端要把账户页所有按钮、校验错误从组件里抽到翻译文件,并支持中英切换不重载
  • 支付模块需按地区显示 €1.234,56 与 $1,234.56,并处理「1 件 / 5 件」等复数文案
  • 中东语系上线前需验证 RTL 下导航栏与表单布局,并配置 HTML `dir` 与镜像样式
  • 上线前用伪本地化拉长字符串,检查表格列宽与弹窗是否被德语文案撑破

适合人员

  • 负责多语言 SaaS 前端的工程师,要把 `react-intl` 接入现有路由并统一 key 命名
  • 编写 Node/Express API 的开发者,需在中间件层解析 `Accept-Language` 并返回本地化错误信息
  • 要带产品进入欧盟或中东市场的技术负责人,需要 Intl、时区与 RTL 的上线检查清单
  • 参与翻译协作的工程师,要定义翻译文件目录、ICU 占位符规范与伪本地化测试流程