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,是设计逻辑。
Git 提交信息生成器。根据代码变更内容自动生成符合 Conventional Commits 规范的提交信息,包含类型、范围、简短描述、详细说明和关联的 Issue/需求号。触发词:生成提交信息、提交信息、commit message、git commit、生成 commit 信息
- 双击打开单个
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,它只忠实执行你下的命令。

















