Raspberry Pi Imager 中 C++ tr() 字符串翻译失效问题分析

在 Raspberry Pi Imager 1.8.5 版本中，用户报告了一个关于字符串翻译的问题：当切换到非英语语言时，C++ 代码中使用 tr() 方法的字符串（如"Erase"和"Use Custom"）未能正确翻译，而 QML 部分的翻译则工作正常。

问题根源

经过深入分析，发现该问题主要由以下几个技术因素造成：

1. 上下文不匹配：Qt 的翻译系统是基于类上下文工作的。tr() 方法会查找与当前类名匹配的翻译上下文，而项目中这些字符串的翻译实际上被放在了"main"上下文中。

2. 翻译文件未更新：当这些字符串从 QML 文件迁移到 C++ 文件时，相应的翻译文件(.ts/.qm)没有同步更新，导致翻译系统无法找到对应的翻译条目。

3. 翻译对象使用不当：tr() 方法作为 QObject 的实例方法，无法指定翻译上下文，这在多上下文环境中容易造成混淆。

4. 竞态条件：语言切换操作与操作系统列表的组装过程存在时间上的竞争关系，导致翻译更新不及时。

解决方案

针对上述问题，开发团队实施了以下修复措施：

1. 替换翻译方法：将所有 tr() 调用替换为 QCoreApplication::translate()，该方法允许显式指定翻译上下文，从根本上解决了上下文不匹配的问题。

2. 更新翻译文件：重新生成翻译文件，确保所有字符串都有正确的上下文映射。

3. 添加同步机制：引入 osListPrepared 信号，在翻译器更换后重新触发操作系统列表的组装过程，消除了竞态条件。

4. 代码结构优化：将松散命名空间中的方法重构为类方法，遵循 Qt 的面向对象设计原则，为未来可能的翻译需求做好准备。

技术启示

这个案例为 Qt 多语言开发提供了几个重要经验：

1. 在大型项目中，应优先使用 QCoreApplication::translate() 而非 tr()，因为它提供了更明确的上下文控制。

2. 字符串位置变更时，必须同步更新翻译文件，这是常见的疏忽点。

3. 动态语言切换需要考虑界面组件的刷新时机，必要时引入额外的同步机制。

4. Qt 的翻译系统严格遵循面向对象原则，代码组织方式直接影响翻译功能的可用性。

通过这次修复，Raspberry Pi Imager 的多语言支持变得更加健壮，为全球用户提供了更一致的使用体验。