用途
Localization (l10n) 是一份面向 Web 与移动应用的本地化实践指南，用于在应用完成国际化（i18n）之后，将其适配到特定地区、语言和文化偏好。它强调本地化建立在国际化之上，要求所有面向用户的文本都支持本地化，内容需符合文化适宜性，并尊重日期、数字和货币的区域惯例，同时为不同语言环境之间差异较大的内容做好设计。
主要能力
本地化库
- Web 应用：使用 i18next 和 react-i18next；采用基于命名空间的翻译组织方式；Next.js 应用可使用 react-intl 或 next-i18next；借助 formatjs 支持 ICU 消息格式。
- 移动应用：React Native 应用使用 expo-localization；可使用 react-native-i18n 或 expo-localization 进行国际化与本地化；支持多语言与回退机制；自动处理设备语言环境检测。
翻译管理
- 文件组织：按 locales/ 目录下以语言区域（如 en-US、en-GB、es-ES、es-MX）分文件夹，内部再按 common.json、legal.json、marketing.json 等命名空间拆分。
- 区域变体：支持区域语言变体（en-US 与 en-GB、es-ES 与 es-MX）；实现回退链（es-MX -> es -> en）；处理拼写差异（color 与 colour）；按区域偏好调整术语。
区域特定格式化
- 日期与时间：使用 Intl.DateTimeFormat 按语言环境格式化，例如美国为 January 23, 2026，英国为 23 January 2026，德国为 23. Januar 2026。
- 数字：使用 Intl.NumberFormat，例如美国为 1,234,567.89，德国为 1.234.567,89，法国为 1 234 567,89。
- 货币：使用 Intl.NumberFormat 的 currency 样式，例如美国/美元为 $1,234.56，德国/欧元为 1.234,56 EUR，日本/日元为 JPY 1,235。
文化适配
- 内容本地化：调整图像以符合文化适宜性；营销内容需本地化而非仅翻译；考虑颜色选择中的文化敏感性；调整示例与引用以贴合当地。
- 法律与合规：本地化隐私政策与服务条款；适配区域法律要求（GDPR、CCPA）；展示适当的监管信息；处理区域特定免责声明。
布局与排版
- 文本膨胀：按英文基础上 30-50% 的文本膨胀进行设计；使用可容纳更长文本的弹性布局；用德语（通常最长）和中文（通常最短）测试；避免对文本使用固定宽度容器。
- RTL 支持：为阿拉伯语、希伯来语等实现完整的从右到左支持；使用 CSS 逻辑属性处理方向性布局；适当镜像 UI 元素；处理双向文本（LTR/RTL 混排）。示例：.card { margin-inline-start: 1rem; padding-inline-end: 0.5rem; text-align: start; }
- 排版考量：使用支持所需字符集的字体；考虑 CJK（中文、日文、韩文）排版需求；支持阿拉伯语及其他文字的特殊要求；为不同语言实现正确的断行。
区域特性
- 地址格式：按区域格式调整地址表单；支持国际电话号码格式；按国家处理邮政编码验证；实现国家特定表单验证。
- 计量单位：支持公制与英制；按语言环境显示合适单位；允许用户偏好覆盖；准确转换数值。
- 日历与时间：支持不同日历系统（公历、伊斯兰历等）；处理时区显示偏好；支持不同周起始日（周日与周一）；显示合适的日期格式。
测试与质量保证
- 本地化测试：由各语言环境的母语者测试；用实际翻译内容验证布局；测试所有日期、数字和货币格式；验证 RTL 布局正常工作。
- 自动化检查：实现缺失翻译检测；检查代码中的硬编码字符串；验证翻译文件格式与完整性；监控翻译质量问题。
- 伪本地化：开发期间使用伪本地化；尽早发现硬编码字符串；验证 UI 能处理文本膨胀；测试字符编码支持。
内容分发
- 语言检测：从浏览器/设备设置检测用户语言；支持基于 URL 的语言环境切换（/en/、/es/、/fr/）；持久化用户语言偏好；实现优雅的回退机制。
- 性能优化：按命名空间懒加载翻译文件；适当缓存翻译；对静态翻译文件使用 CDN；最小化初始翻译包体积。
集成最佳实践
- 状态管理：在用户设置中存储语言环境偏好；登录时跨设备同步偏好；无需整页刷新即可处理语言环境变更；语言环境切换时更新所有组件。
- API 集成：在 API 请求中传递语言环境；适当时从后端返回本地化内容；处理服务端语言环境协商；支持内容协商头。
使用方式
该资料以指南形式给出本地化实施要点，包含代码示例（日期、数字、货币格式化函数，以及 RTL 的 CSS 逻辑属性写法）和目录结构示例。开发者可据此在项目中选用对应库、组织翻译文件、实现格式化与布局适配，并建立测试与分发流程。
适用场景
适用于需要面向多地区、多语言用户发布 Web 或移动应用的团队，尤其是涉及区域变体（如 en-US 与 en-GB）、RTL 语言、CJK 排版、区域法律合规以及多语言内容分发的项目。
限制
资料未提供具体的安装命令、版本要求、收费或价格信息、平台限制以及可量化的效果数据，这些内容暂未提供。