Sublime Text的Git插件非开箱即用，需满足三条件：系统已装git且PATH可达、Sublime通过Open Folder打开含.git/的根目录、当前文件路径能向上查找到.git/；否则Git: Status等命令将灰显或报错。
Sublime Text 的 Git 插件不是开箱即用的“Git GUI”，它只是把系统 git 命令封装进命令面板和右键菜单——插件本身不带 git，也不自动识别仓库，更不会帮你配好环境变量。绝大多数问题都出在这三层脱节：系统没装 git、Sublime 没读到 git 路径、当前文件不在有效仓库上下文中。
Git 命令面板里搜不到 Git: Status？先确认三件事
这不是插件坏了，是 Sublime 根本没进入 Git 上下文。它只从当前编辑文件的完整路径向上逐级查找 .git/ 目录，找到才激活所有 Git 命令。
- 你必须用 File → Open Folder… 打开包含
.git/的根目录，而不是双击打开单个index.js文件（哪怕它就在仓库里） - 侧边栏显示的“项目文件夹”不等于 Git 仓库——Sublime 的
.sublime-project文件对 Git 插件完全无效 - 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Git: Status；如果命令灰显或不出现，说明插件已加载但没识别到仓库
报错 “git is not recognized” 或 FileNotFoundError？PATH 没透过去
插件调用的是系统 git 可执行文件，不是自带的。终端能跑 git --version，但 Sublime 里不行，99% 是 GUI 启动方式绕过了 shell 配置文件。
- macOS：GUI 应用默认不读
~/.zshrc，改用~/.zprofile设置PATH，然后执行killall Dock重启 Dock - Windows：重装 Git for Windows，务必勾选 Add Git to the system PATH；已装错就手动把
C:\Program Files\Git\cmd加进系统环境变量，再重启 Sublime 和命令提示符 - Linux：桌面启动的 Sublime 不加载
~/.bashrc，建议用终端执行subl .启动，或修改.desktop文件的Exec=env PATH=$PATH subl %F
右键没 Git 菜单、状态栏不刷新、stash 后看不到变化？别怪插件
Git 插件只做命令转发，不维护状态缓存、不监听文件系统、不自动重绘 UI 元素。它甚至不感知你刚 git stash 了什么。
- 右键无菜单 = 当前文件路径未命中任何
.git/目录（包括子模块里的.git文件指向外部时，插件也识别失败） - 状态栏右下角分支名仍显示
main*即使你已git stash—— 这是正常行为，插件不会主动刷新，需手动执行Git: Status或切换标签页 -
Git: Stash后想恢复？只能走命令面板：Git: Stash Pop（恢复并删掉）、Git: Stash Apply（恢复但保留），没有快捷键，也不能从右键调用
想看哪几行改了？Git 插件不够，得加 GitGutter
Git 插件只提供提交、推送、日志等命令入口，**不负责视觉标记**。左侧 gutter 显示 +、~、- 图标是 GitGutter 的职责。
- 安装
GitGutter后，默认只标已git add过的文件；新增未跟踪文件不显示图标，需在设置中加"show_untracked": true - 性能敏感时可关实时刷新：
"live_mode": false，改为仅在保存或切标签页时更新 gutter - 图标不出现？先确认：文件路径是否在
.git/所在目录的子路径下；终端进同一目录运行git status是否能识别仓库
最常被忽略的一点：Sublime 的 Git 插件对 core.editor 高度敏感。如果你设过 git config --global core.editor "code --wait"，而 VS Code 没装或没配置好，Git: Commit 就会卡住或弹空白窗口——这时候得回退到 Sublime 自带的 commit buffer，或者改用 git_commit_command": "git commit -m" 绕过编辑器调用。
