正确插件名为git(wbond维护),非gitcommit等错误名称;需通过package control安装,且必须在含.git/的项目根目录下打开,系统git命令须已加入path并确保可调用。

Sublime Text 本身没有叫 GitCommit 的“标准包”——这个名字不存在,也不是官方维护或社区广泛认可的插件。你搜到的大概率是拼写错误、混淆命名,或是某个已废弃/小众分支的非主流 fork。
为什么搜不到 GitCommit?
Sublime Text 生态中唯一被广泛采用、持续更新、由 wbond 维护的 Git 插件就叫 Git(纯英文名,无后缀)。它不叫 GitCommit、SublimeGit、GitSavvy 或 SideBarGit:
-
GitCommit不在 Package Control 官方仓库索引中,执行Package Control: Install Package后搜索该词,结果为空或匹配到无关插件 -
SublimeGit自 2017 年起停止维护,无法兼容 ST4,右键菜单和命令面板常失效 -
GitSavvy是另一套独立实现,依赖 Python subprocess 调用 git,但会与官方Git插件冲突,且配置复杂、中文支持差 - 所有带
Commit字样的插件(如GitCommit)基本是用户自建、未上架、或仅含单个 commit 命令的阉割版,缺乏git add、git push、状态监听等基础能力
真正该装的是 Git 插件(wbond 版)
这个插件不封装逻辑,只做轻量桥接:把你的系统 git 命令暴露为 Sublime 内部命令。装对了,Ctrl+Shift+P 才能唤出 Git: Status、Git: Add、Git: Commit、Git: Push 等真实可用项:
- 安装路径必须严格:打开命令面板 → 输入
Package Control: Install Package→ 搜索Git→ 认准作者是wbond、描述含command-line git integration - 装完不生效?先检查是否在含
.git/的目录下打开项目(File → Open Folder…),单文件打开或子目录打开均无效 - 命令灰显或报
"git" is not recognized?不是插件问题,是你系统的git没透进 Sublime 启动环境:Windows 重装 Git 时勾选Add Git to the system PATH;macOS/Linux 建议从终端执行subl .启动编辑器
Git: Commit 怎么用?不是点一下就完事
这个命令不会弹窗让你填框,而是新建一个临时 tab,第一行写 commit message,保存即提交(相当于 git commit -m "xxx")。容易卡住或失败的常见原因:
- 没先执行
Git: Add(或右键文件选Git: Add),直接Git: Commit会提示 “nothing to commit” - commit message 留空或只写了空格,保存后提交会被跳过,无报错但无效果
- 当前分支没设置 upstream(比如首次 push),
Git: Push会失败,需先在终端跑git push -u origin main建立追踪 - 中文 commit message 在某些终端环境下乱码,可在
Preferences → Package Settings → Git → Settings – User中加一行:"git_pager": "cat"关闭分页器
真正麻烦的从来不是“装哪个包”,而是让 git 可执行文件、PATH 环境变量、项目根目录、分支追踪这四者对齐。名字输错一次,后面所有操作都像在黑盒里按按钮。











