SourceGit中关于未跟踪文件暂存行为的技术解析

在Git版本控制系统中，暂存(stash)是一个非常有用的功能，它允许开发者临时保存工作目录中的修改而不需要提交。SourceGit作为一款Git图形客户端，在处理未跟踪文件的暂存行为上经历了一次重要的行为调整。

问题背景

在早期的SourceGit实现中，当用户选择"包含未跟踪文件"进行暂存时，系统会先将这些未跟踪文件添加到暂存区(stage)，然后再执行暂存操作。这导致了一个不太符合用户预期的行为：当这些暂存的修改被重新应用(pop)时，原本未跟踪的文件会变成已暂存状态，而不是恢复为原始的未跟踪状态。

技术实现分析

这种设计最初是参考了另一款知名Git客户端Fork的实现方式。经过深入分析，发现Fork采用这种设计主要有两个技术原因：

1. 兼容性考虑：在Git 2.32.0之前的版本中，git stash show命令不支持-u/--include-untracked参数，这意味着无法直接查看暂存中包含的未跟踪文件的差异。

2. 差异查看限制：如果未跟踪文件在暂存前没有被添加到暂存区，用户将无法使用git diff stash@{N} -- /path/to/file或git diff <stash_hash>^ <stash_hash>等命令查看这些文件的差异内容。

解决方案演进

SourceGit团队经过技术评估后，决定改进这一行为：

1. 放弃依赖git stash show：新实现不再使用git stash show命令来查询暂存中的变更，而是改用现有的Commands.CompareRevisions功能，该功能基于git diff命令实现。

2. 完整支持Git原生行为：对于Git 2.32.0及以上版本，完全支持原生的-u/--include-untracked参数行为，确保未跟踪文件在暂存和应用后保持其原始状态。

3. 正确处理暂存区状态：修复了在应用暂存时丢失--index参数的问题，确保已暂存的修改在重新应用后能正确恢复到暂存区。

技术影响

这一改进使得SourceGit在处理未跟踪文件的暂存行为上：

1. 更加符合Git原生命令的预期行为
2. 提供了更一致的用户体验
3. 保持了对旧版本Git的兼容性
4. 解决了查看暂存中未跟踪文件差异的技术限制

最佳实践建议

对于使用SourceGit的开发者：

1. 更新到最新版本以获得最符合预期的暂存行为
2. 对于包含未跟踪文件的暂存操作，现在可以放心使用，系统会保持文件的原始状态
3. 当需要查看暂存中的未跟踪文件差异时，可以直接使用内置的差异比较功能

这一改进体现了SourceGit团队对用户体验的重视和对Git底层原理的深入理解，使得这款Git客户端在功能完整性和易用性上又向前迈进了一步。