VS Code中Project Manager扩展不显示Git标签如何解决

问题现象 #

• 两台设备均安装VS Code及Git Extension Pack扩展包，其中一台设备的Project Manager面板未展示Git标签，另一台同配置设备显示正常。

已完成排查 #

• 卸载Git Extension Pack后Git标签仍可正常显示，说明标签功能不直接依赖Git Extension Pack本体运行。
• 确认Project Manager及其标签功能依赖独立扩展Project Manager v12.6.0，该扩展为Git Extension Pack的内置捆绑组件，多次重装该扩展后故障仍未解决。

相关截图 #

排查修复步骤 #

按以下顺序操作即可定位并解决问题：

• 校验扩展配置项
  打开VS Code设置页，搜索projectManager.git相关配置，逐项确认：
  • projectManager.showGitTags：值必须为true，该选项直接控制Git标签是否在面板展示
  • projectManager.git.baseFolders：需添加本地存放Git仓库的根目录路径，未配置扫描路径时扩展无法识别Git仓库，会自动隐藏Git标签
  • projectManager.git.maxDepthRecursion：值不能为0，常规使用设置为2-4即可覆盖大部分目录结构
• 验证本地Git环境
  在异常设备的VS Code内置终端执行git --version，如果命令报错，说明Git未正确加入系统环境变量：需重装Git，安装时勾选「Add Git to system PATH」选项，完成后重启VS Code重试。
• 清除扩展缓存重置状态
  1. 完全退出所有VS Code进程
  2. 打开对应系统的VS Code工作区存储目录：
     • Windows：打开资源管理器地址栏输入%APPDATA%\Code\User\workspaceStorage回车
     • macOS：访达前往文件夹输入~/Library/Application Support/Code/User/workspaceStorage
     • Linux：路径为~/.config/Code/User/workspaceStorage
  3. 在目录下搜索所有名称包含alefragnani.project-manager的文件夹，全部删除
  4. 重启VS Code，等待扩展重新初始化完成后查看标签是否恢复
• 排查扩展冲突
  禁用所有第三方扩展，仅保留Project Manager及Git核心扩展，重启VS Code测试：如果Git标签恢复显示，逐个启用扩展定位冲突项，常见冲突来源为自定义侧边栏修改类扩展、其他同类型项目管理扩展。
• 检查版本兼容性
  确认异常设备的VS Code版本不低于1.68.0（Project Manager v12.6.0的最低运行要求），版本不满足时升级VS Code到最新稳定版即可。

内容的提问来源于stack exchange，提问作者NewbieProgrammer