SourceGit项目中子模块变更丢失问题的分析与解决方案

问题现象

在SourceGit项目中，当用户尝试通过图形界面"丢弃更改"功能对单个文件进行操作时，系统错误地触发了全量丢弃行为。具体表现为：在变更列表中仅存在一个文件修改的情况下，丢弃该文件会导致项目子模块中的所有未提交变更也被意外清除。

技术背景

Git子模块(Submodule)是Git仓库中嵌套的独立Git仓库，用于管理项目依赖。SourceGit作为Git图形客户端，需要正确处理子模块的特殊性。在底层实现上，Git通过--recurse-submodules参数实现对子模块的递归操作。

问题根源

通过分析源代码发现，SourceGit的"丢弃更改"功能实现存在逻辑缺陷：

1. 无论用户选择丢弃单个文件还是全部更改，系统都统一使用git restore . --source=HEAD --staged --worktree --recurse-submodules命令
2. 该命令中的.参数表示对工作区所有文件进行操作，加上--recurse-submodules标志后，会递归影响所有子模块
3. 未针对单个文件丢弃场景做特殊处理，导致范围控制失效

解决方案

开发团队已修复该问题，主要改进包括：

1. 区分"丢弃单个文件"和"丢弃所有更改"的操作场景
2. 对于单个文件丢弃场景，精确指定文件路径而不使用通配符
3. 确保子模块操作的可控性，避免意外影响

最佳实践建议

1. 重要子模块变更建议先单独提交
2. 执行批量操作前，使用git status确认影响范围
3. 升级到修复版本后，单个文件丢弃操作将不再影响子模块
4. 对于复杂场景，可考虑命令行操作以获得更精确的控制

总结

该案例展示了Git图形客户端在处理复杂场景时需要特别注意的边界条件。SourceGit团队通过精确控制操作范围，解决了子模块意外清除的问题，提升了工具的可靠性。用户应当注意保持客户端版本更新，以获得最佳的使用体验。