git插件是sublime text唯一持续维护的纯命令行git工具，需正确配置git_command路径、以文件夹方式打开含.git的项目，并严格按add→commit→push流程操作。
Git 是 Sublime Text 唯一真正可用、持续维护、且只做一件事的 Git 插件：调用你本地的 git 命令行工具。它不渲染图形、不内置合并器、不自动拉取，但只要环境配对，git: add → git: commit → git: push 这三步就能稳稳走通。
GitSavvy 也能用，功能更全（比如带字符化 git log --graph 视图），但它和 Git 插件冲突——装了其中一个，另一个的命令会消失或失效。别两个都装。
SublimeGit 和 GitGutter 不是替代选项：SublimeGit 已停更 9 年，与 Sublime Text 4 的 Python 3.8+ 不兼容，装了就报 ImportError: No module named git；GitGutter 只画侧边栏小图标，右键根本没 Git → Add File 菜单。
怎么确认 git_command 路径写对了
终端里 git --version 成功 ≠ Sublime 能调用它。GUI 启动的 Sublime 默认看不到 shell 的 PATH，尤其 macOS（Homebrew）和 Windows（Git for Windows 安装路径含空格或反斜杠）。
- macOS 用户运行
which git，常见输出是/opt/homebrew/bin/git，就在Preferences → Package Settings → Git → Settings – User里填：{"git_command": "/opt/homebrew/bin/git"} - Windows 用户运行
where git，常见路径是C:Program FilesGitingit.exe，注意反斜杠必须双写或改用正斜杠：{"git_command": "C:\Program Files\Git\bin\git.exe"} - 验证是否生效：按
Ctrl+`打开 Sublime 控制台，输入import subprocess; subprocess.run(['git', '--version'])，有输出即通
Git: Status 没反应？先看项目打开方式
插件不会全局激活。它只在「当前窗口是从 File → Open Folder… 打开、且该文件夹下存在 .git/ 目录」时才加载命令。这不是 bug，是设计逻辑。
- 双击打开单个
src/index.js文件？插件静默，Git: Status灰显或搜不到 - 从子目录（如
project/src）打开？向上找不到.git/，同样不激活 - 正确做法：确保资源管理器/访达里定位到项目根目录（能看到
.git文件夹），再用Open Folder…打开整个文件夹 - 输
Git: Status后弹出只读面板，灰色文件 = 未暂存，绿色 = 已暂存 —— 这才是插件已就位的信号
从 add 到 push，为什么总卡在 git: commit 无反应
这个插件不自动暂存，也不默认提交所有改动。git: commit 只作用于已暂存（staged）文件，漏掉 git: add，提交就是空的。
- 先执行
Git: Status，确认要提交的文件是灰色（modified/untracked） - 把光标放在灰色文件名上，按
Ctrl+Shift+P→Git: Add File；或右键该文件 →Git → Add File - 再运行
Git: Commit，会弹出新标签页让你写 message，保存即提交到本地仓库（不是远程） - 最后运行
Git: Push。首次推送需先设 upstream：选Git: Push with Options，勾选set upstream
git: push 报错 “no upstream configured” 或 “rejected” 时，别急着重试——大概率是远程分支已有新提交，你得先 git: pull 再 push。插件不自动提醒，也不帮你 merge，它只忠实执行你下的命令。
