SourceGit项目法语翻译重复键问题分析与修复

问题背景

SourceGit是一款开源的Git客户端工具，在最新版本中出现了一个导致程序无法启动的关键错误。该错误与法语语言包(fr_FR.axaml)中的翻译键重复有关，当系统尝试加载法语资源时，由于字典中存在重复键，触发了System.ArgumentException异常。

错误现象

当用户尝试启动SourceGit时，程序抛出以下异常信息：

System.ArgumentException: An item with the same key has already been added. Key: Text.CommitCM.Checkout

这表明在法语资源文件中存在多个相同键的定义，导致资源字典无法正常构建。

技术分析

根本原因

通过分析提交历史，发现这个问题源于提交904432a8f1d63472f913071ad1e52f5a8e5fa582引入的变更。在该提交后，法语翻译文件中出现了多处键名重复的情况，包括但不限于：

1. 界面操作相关键：

   • Text.CommitCM.Checkout
   • Text.StashCM.SaveAsPatch
   • Text.BranchCM.CustomAction

2. 功能设置相关键：

   • Text.SetUpstream
   • Text.SetUpstream.Local
   • Text.SetUpstream.Upstream

3. AI辅助功能相关键：

   • Text.AIAssistant.Use
   • Text.AIAssistant.Regen

资源加载机制

SourceGit使用Avalonia UI框架的资源字典机制来管理本地化资源。当程序启动时，会尝试加载指定语言的所有翻译条目到一个字典结构中。字典数据结构要求所有键必须唯一，因此当遇到重复键时就会抛出异常。

解决方案

开发团队通过以下步骤解决了这个问题：

1. 问题定位：通过异常堆栈追踪到具体的资源文件和重复键
2. 全面检查：对所有法语翻译键进行系统性的重复项检查
3. 修复提交：在提交82f4138和a5478b8中移除了所有重复的翻译键定义
4. 验证测试：确保修复后程序能正常启动并加载法语资源

经验总结

1. 本地化管理：在多语言项目中，应该建立键名命名规范和管理机制，避免重复定义
2. 自动化检查：可以考虑在构建流程中加入资源键唯一性检查的自动化脚本
3. 代码审查：对于资源文件的修改应该纳入严格的代码审查流程
4. 测试覆盖：增加本地化资源加载的单元测试，提前发现类似问题

对用户的影响

这个问题的修复使得：

• 法语用户能够正常使用SourceGit
• 所有涉及重复键的功能都能正确显示翻译文本
• 程序启动稳定性得到提升

对于开发者而言，这个案例也提醒我们在进行国际化开发时需要特别注意资源键的唯一性管理。