SourceGit项目在Windows 11上启动崩溃问题分析与解决方案

问题背景

近期有用户反馈，在Windows 11系统上更新SourceGit至2025.12版本后，应用程序无法正常启动。通过日志分析发现，程序在初始化阶段抛出了"An item with the same key has already been added"的异常，导致启动失败。

技术分析

根据错误日志显示，问题发生在资源字典加载阶段。具体异常信息表明，在加载法语本地化资源文件(fr_FR.axaml)时，系统检测到重复的键值"Text.CommitCM.Checkout"。

这种问题通常是由于：

1. 资源文件中存在重复定义的键
2. 资源合并过程中出现冲突
3. 多语言资源加载机制存在缺陷

在Avalonia框架中，ResourceDictionary作为资源容器，不允许存在重复键。当程序尝试加载包含重复键的资源时，就会抛出ArgumentException异常。

影响范围

该问题主要影响：

• 使用Windows 11系统的用户
• 安装2025.12版本的用户
• 使用法语界面的环境（其他语言可能不受影响）

解决方案

项目维护者已在2025.13版本中修复了此问题。用户可以通过以下方式解决：

1. 等待winget自动更新到2025.13版本
2. 手动回退到2025.11版本（临时解决方案）
3. 检查本地化资源文件，移除重复键值（开发者解决方案）

最佳实践建议

对于开发者而言，可以采取以下措施避免类似问题：

1. 在资源文件中使用唯一键命名
2. 实现资源加载前的键值检查机制
3. 建立自动化测试验证多语言资源加载
4. 使用资源合并工具时注意冲突检测

总结

本地化资源管理是跨平台应用开发中的重要环节。SourceGit此次出现的问题提醒我们，在维护多语言支持时需要特别注意资源键的唯一性。通过版本迭代和社区反馈，项目团队快速响应并解决了这一问题，展现了开源项目的协作优势。