GitLens 15.4.0 分支视图分组问题解析与修复

问题背景

在 GitLens 15.4.0 版本更新后，用户反馈了一个关于分支视图显示的问题。当使用 Git 工作树（worktree）功能时，原本应该按照文件夹结构分组显示的分支（如 develop/* 和 release/*）不再被正确折叠，而是全部展现在顶层视图中，这影响了用户对大量分支的管理效率。

问题分析

GitLens 的分支视图设计了一个智能分组功能，能够将相似前缀的分支自动折叠成文件夹结构。例如：

• 所有 develop/ 开头的分支会被折叠到 "develop" 文件夹下
• 所有 release/ 开头的分支会被折叠到 "release" 文件夹下

然而，在 15.4.0 版本中，这个功能出现了一个逻辑错误：所有位于工作树中的分支都被排除在了分组逻辑之外，而原本的设计意图是只排除当前窗口中打开的工作树分支（类似于当前分支的特殊处理）。

技术细节

1. Git 工作树（worktree）：Git 的一个功能，允许用户同时检出多个分支到不同的工作目录，每个工作树都有自己的工作区和索引。

2. 分支视图分组逻辑：

   • 正常情况下，相同前缀的分支会被自动分组
   • 当前分支会特殊处理，保持展开状态
   • 工作树中的分支本应只对当前窗口打开的工作树特殊处理

3. 问题根源：版本更新后错误地将所有工作树分支都排除在了分组逻辑之外，而不仅仅是当前窗口的工作树分支。

解决方案

GitLens 团队迅速响应，在预发布版本 v2024.9.605 中修复了这个问题。修复内容包括：

1. 调整了分支分组逻辑的判断条件
2. 确保只有当前窗口中打开的工作树分支才会被特殊处理
3. 其他工作树中的分支仍然参与正常的分组折叠

验证结果

用户验证了预发布版本后确认：

• develop/* 分支正确折叠到 develop 文件夹下
• release/* 分支正确折叠到 release 文件夹下
• 当前工作树中的分支保持展开状态
• 功能恢复正常预期行为

最佳实践建议

对于使用 GitLens 管理大量分支的用户：

1. 合理使用分支命名规范（如前缀分组）
2. 善用工作树功能管理并行开发
3. 定期更新 GitLens 以获取最新功能和修复
4. 遇到类似显示问题时，可以尝试切换到预发布版本验证修复

这个问题展示了 GitLens 团队对用户体验的重视和快速响应能力，也提醒我们在使用版本控制工具时要关注更新日志和已知问题。