sublime text 无内置 git 功能，所有操作依赖插件调用系统 git 命令；git not found 错误主因是启动时未加载 path；需通过终端 subl . 打开项目、确保项目根含 .git 目录、正确配置 git_command 和 commit 命令。
git 命令。这是最关键的前置认知——如果你在菜单或命令面板里看到“Git”相关选项，那一定是你装了插件，不是编辑器自带的。
Git not found 错误的本质原因
插件报这个错，90% 是因为 Sublime 启动时没加载到系统的 PATH 环境变量，哪怕你在终端里 git --version 跑得飞起。
- macOS：图形界面启动的 Sublime 不读
~/.zshrc或~/.bash_profile，必须用终端执行subl .打开项目，或修改Sublime Text.desktop的Exec=行，加上env PATH=$PATH - Windows：安装 Git for Windows 时没勾选 “Add Git to the system PATH”，或安装后没重启 Sublime
- Linux：桌面环境（如 GNOME）启动 Sublime 时默认不加载 shell 配置，
whereis git查到路径后，可在Preferences → Package Settings → Git → Settings – User中硬编码："git_command": "/usr/bin/git"
Git 插件必须在项目根目录打开才能工作
插件不会递归扫描父目录找 .git/，它只认当前窗口的“项目根”——也就是你通过 File → Open Folder 打开的那个文件夹，且该文件夹下必须存在 .git/ 目录。
- 错误做法：双击打开单个
src/main.py文件，即使它属于某个 Git 仓库，插件所有命令都会灰显或报错 - 正确做法：关闭当前文件，用
File → Open Folder选中包含.git/的整个项目目录 - 验证方式：状态栏左下角应显示分支名（如
main）和修改数（如2 modified），没有则说明未识别为仓库
Git: Add Selected Hunk 的真实使用条件
这个功能不是点一下就高亮选中代码块然后暂存，它对文件状态和选择范围有硬性要求：
- 文件必须已存在于工作区（不能是全新未跟踪的
??状态） - 选中的代码块必须是“已修改但未暂存”的部分（即
git status显示为M的文件） - 不能跨函数或跨空行选——Sublime 会按 Git 的 hunk 边界自动截断，如果选区太碎，命令可能静默失败而不提示
- 执行后不会弹窗反馈，需手动运行
Git: Status查看该文件是否出现A（已暂存）标记
提交模板失效的两个隐藏配置点
Git: Commit 弹出的模板不是固定文案，它受两处设置控制，改错一个就变回空白输入框：
-
Preferences → Package Settings → Git → Settings – User中必须保留"git_commit_command": "git commit"，删掉或改成"git commit -m"会导致模板不生成 - 全局 Git 配置不能禁用 editor：
git config --unset core.editor，否则 Sublime 会卡在等待外部编辑器返回，看起来像“点了没反应” - 模板内容实际来自
.git/COMMIT_EDITMSG的历史缓存，首次使用前建议先用命令行提交一次，生成初始模板结构
subl . 养成习惯，比调一百次设置更管用。
