OpenWrt LuCI 国际化翻译退化问题分析

在OpenWrt LuCI项目22.03版本中，用户发现部分界面元素的翻译出现了退化现象，特别是"Login"(登录)和"Logout"(登出)等基础功能按钮的翻译丢失，导致界面显示为英文原文而非本地化语言。

问题背景

OpenWrt LuCI作为路由器Web管理界面，其国际化(i18n)功能对于非英语用户至关重要。项目使用标准的gettext工具链进行翻译管理，包括.po(可移植对象)和.mo(机器对象)文件。翻译文件需要与源代码中的字符串标识保持严格同步。

问题根源

经分析，该问题源于一次不当的代码合并操作。在22.03稳定分支中，开发人员直接cherry-pick了来自主分支的翻译文件变更，而没有考虑两个分支间源代码字符串的差异。具体表现为：

1. 主分支已修改了相关字符串标识(如将"Logout"改为"log out")，但22.03分支仍保持原字符串
2. 直接合并导致22.03分支的翻译文件中：
   • 原有"Logout"的翻译被移除
   • 新增了不存在的"log out"字符串翻译
3. 后续正常的i18n同步过程无法恢复已删除的翻译

技术细节

正确的国际化维护流程应该是：

1. 只应通过专门的i18n合并工具同步翻译
2. 跨分支合并必须考虑字符串标识的版本差异
3. 翻译更新应基于实际存在的源代码字符串

在此案例中，直接cherry-pick破坏了翻译文件与实际字符串的对应关系，导致：

• 有效翻译被错误移除
• 引入了无效的翻译条目
• 后续自动化同步无法自动修复

解决方案

项目维护者已采取以下修复措施：

1. 恢复22.03分支原有的字符串标识和对应翻译
2. 确保后续翻译更新通过正确的i18n合并流程进行
3. 加强代码审查，防止类似直接合并翻译文件的情况

经验总结

此案例为开源项目国际化维护提供了重要经验：

1. 翻译文件不是独立资产，必须与源代码字符串严格对应
2. 跨分支合并需特别谨慎，应考虑使用专用工具而非直接cherry-pick
3. 自动化同步工具无法修复人为错误导致的翻译不一致
4. 稳定分支应保持字符串标识的稳定性，避免不必要变更

对于OpenWrt用户，如果遇到类似翻译缺失问题，可以检查：

1. 安装的语言包是否完整
2. 系统版本与语言包版本是否匹配
3. 必要时可报告问题并等待官方修复更新