git: status搜不到，是因为sublime未识别git仓库上下文：必须用file→open folder打开含.git/的项目根目录，不能双击单文件；确保git cli可用且path已透传；.sublime-project文件对插件无效。
Git命令面板搜不到 Git: Status？先确认三件事
这不是插件没装好，是 Sublime 根本没识别到 Git 仓库上下文。它只从当前编辑文件的完整路径向上逐级查找 .git/ 目录，找到才激活所有命令。
- 必须用 File → Open Folder… 打开包含
.git/的项目根目录，而不是双击打开单个index.js文件（哪怕它就在仓库里） - 侧边栏显示的“项目文件夹”不等于 Git 仓库——
.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 菜单、状态栏分支名不更新？插件不监听也不缓存
Git 插件只做命令转发，不维护状态缓存、不监听文件系统、不自动重绘 UI 元素。它甚至不感知你刚 git stash 了什么。
- 右键无菜单 = 当前文件路径未命中任何
.git/目录（包括子模块里的.git文件指向外部时，插件也识别失败） - 状态栏右下角分支名仍显示
main*即使你已git stash—— 这是正常行为，插件不会主动刷新，需手动执行Git: Status或切换标签页 -
Git: Stash后想恢复？只能走命令面板：Git: Stash Pop（恢复并删掉）、Git: Stash Apply（恢复但保留），没有快捷键，也不能从右键调用
Git: Commit 提交不了？它不跳过 git add
这个插件是轻量 CLI 封装，不是 IDE。它不支持 -a 或 --amend，想跳过 git add 直接提交所有修改？得先手动执行 Git: Add 或切终端。
-
Git: Diff默认对比工作区和暂存区，若文件未git add过，看到的是空 diff —— 这不是 bug，是 Git 本身行为 - 中文
commit message乱码？关掉 Git 的 pager：git config --global pager.log false（Sublime 日志面板不依赖less） - 所有命令只对当前文件所在仓库生效，不支持跨文件夹批量操作；右键菜单/快捷键在非 Git 目录下自动失效
最容易被忽略的点是：插件从不“猜”你在哪个仓库、不自动重载状态、不继承 shell 环境变量——它只认路径、只调命令、只等你手动触发。一旦路径或 git_command 配错，所有功能都会静默失效。
