Sublime Text 的 Git 插件需正确配置系统 git 路径且工作目录必须为仓库根目录，否则功能失效；插件仅调用命令不自带 Git，也不处理合并冲突。
Sublime Text 本身不带 Git，所谓“配置工作流”本质是让插件能稳定调用系统 git 命令，并在正确路径上下文中生效。90% 的失败不是操作问题，而是 git 找不到，或当前文件不在仓库根目录下。
Git 插件装完没反应？先验证 git 是否被 Sublime 真正识别
插件只调用系统命令，不自带 git。终端里能跑 git --version ≠ Sublime 能继承这个环境——尤其 macOS GUI 启动、Linux 桌面环境、Windows PATH 配置错时，git 经常不可见。
- Windows：运行
where git，若返回类似C:\Program Files\Git\bin\git.exe，就把这路径填进Preferences → Package Settings → Git → Settings – User，写成：{"git_command": "C:/Program Files/Git/bin/git.exe"}（用正斜杠或双反斜杠） - macOS：Homebrew 安装的
git通常在/opt/homebrew/bin/git；GUI 启动 Sublime 不加载 shell 配置，要么从终端执行open -a "Sublime Text"，要么硬编码git_command - Linux：桌面启动常丢
$PATH，推荐终端执行subl .；或改sublime-text.desktop的Exec=行为，加env PATH=$PATH
右键没 Git 菜单、Git: Status 灰显？检查是否在有效仓库路径内
插件只在「当前窗口根路径下存在 .git/ 目录」时才激活。拖一个 .js 文件进去、或在 /src/utils/ 子目录打开，插件直接“隐身”。
- 必须用
File → Open Folder…打开整个仓库根目录（即.git所在目录） - 侧边栏顶部显示的路径应包含
.git（如/Users/me/project/.git） - 按
Ctrl+Shift+P输入Git: Status，能执行并输出分支名和修改文件数，才算真正就位 - monorepo 场景下，若只想管子包，可在该子目录单独
git init，或用git worktree分离管理
Git: Push 报 “No configured push URL”？这不是 Sublime 的锅
这是 Git 本身的约束：首次推送必须显式指定上游分支。Sublime 插件只是透传命令，不会自动补参数。
- 终端里执行一次：
git push -u origin main（把main换成你当前分支名） - 之后
Git: Push就能直接用了；如果远程名不是origin，得先git remote add origin <url> - 别指望插件帮你解决
push.default问题——它默认不设，你得自己运行：git config --global push.default matching
快捷键和常用命令怎么用？记住几个核心组合就够了
所有快捷键只在仓库内生效，灰显就是路径不对，不是快捷键失效。
-
Ctrl+Shift+G（Git: Status）：看状态，Enter 选中文件后按s暂存、u撤销、d查 diff -
Ctrl+Shift+K（Git: Commit）：弹出临时文件写 message，换行用Shift+Enter，不支持-a或--amend -
Ctrl+Shift+H（Git: Add）：对当前文件执行git add；侧边栏多选后右键也能批量加 - 右键文件 →
Git → View File Status：快速确认是否已跟踪、是否修改
真正容易被忽略的是：插件不处理合并冲突，也不提供图形化分支管理。一旦遇到 rebase 冲突或复杂 cherry-pick，还是得切到终端手动 resolve——轻量不等于万能，别把它当 Git GUI 用。
