Sublime Text 4143版本Git侧边栏标记异常问题

问题详情 #

Ubuntu 22.04 环境下使用 Sublime Text 4143，遇到 Git 侧边栏标记异常问题：未加入索引的新建文件，部分显示空心圆圈标记，部分不显示；最初以为和创建方式有关（终端通过touch/echo创建的文件显示标记，ST内创建的不显示），但后续测试发现ST内创建的文件也可能显示标记，且问题无法100%复现——新增文件后旧文件的标记可能突然消失，比如同一文件夹内逐个新建4个文件，前三个有标记，添加第四个后所有标记都消失。ST控制台无报错，其他Git集成功能（提交、拉取等）运行正常。

解决步骤 #

1. 手动刷新Git状态 #

ST的Git状态缓存可能出现异常，手动触发强制刷新：

• 按 Ctrl+Shift+P 打开命令面板
• 执行 Git: Refresh 命令，让ST重新读取仓库状态

2. 删除ST的Git缓存文件 #

缓存文件损坏会导致状态识别异常，直接删除后让ST重新生成：

• 关闭Sublime Text
• 进入路径 ~/.config/sublime-text/Local/，删除名为 Git Status.sublime-cache 的文件
• 重启ST，观察标记是否恢复正常

3. 检查Git仓库本身状态 #

确认Git仓库能正常识别未跟踪文件，排除仓库自身问题：

• 终端进入项目根目录，执行 git status，查看所有未跟踪文件是否被Git正常列出
• 如果Git识别正常但ST仍异常，执行 git gc 清理仓库垃圾，优化仓库状态

4. 排查插件冲突 #

第三方Git相关插件可能干扰ST原生集成：

• 打开命令面板，执行 Package Control: Disable Package
• 暂时禁用所有非官方Git插件（如GitGutter等）
• 重启ST测试，若标记恢复正常，再逐个启用插件排查冲突源

5. 调整Sublime Text版本 #

当前4143版本可能存在特定bug：

• 尝试降级到上一个稳定版（如4142），或等待官方推送新版本修复
• 版本历史可从ST官网的版本列表中获取

6. 检查文件系统权限 #

确保ST有足够权限读取项目文件：

• 终端执行 sudo chown -R $USER:$USER /path/to/your/project，将项目目录权限设置为当前用户
• 重启ST后测试标记状态

临时替代方案 #

如果以上方法均无效，可通过命令面板快速查看未跟踪文件：

• 按 Ctrl+Shift+P 打开命令面板，执行 Git: List Untracked Files，直接查看所有未跟踪文件列表

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