先确认package control是否安装成功,再安装git插件并配置git_command路径、push.default参数及ssh密钥,最后在含.git的项目根目录下操作。

Git 插件装不上,先看 Package Control 是否就位
Sublime Text 本身不带 Git 功能,所有操作都依赖插件,而插件必须通过 Package Control 安装。如果按 Ctrl+Shift+P 调不出命令面板,或输入 Install Package 没反应,说明 Package Control 没装好或失效了。
验证方式:菜单栏 Preferences → Package Control 存在即正常;不存在就得重装——去 https://packagecontrol.io/installation 复制对应 Sublime 版本(ST4 需用 Package Control 4.x)的 Python 代码,粘贴进 View → Show Console 执行。
常见坑点:
- 用过“绿色版”或第三方汉化包的,常会屏蔽
Package Control的网络请求,导致插件列表空白 - Sublime Text 4 启动时若没从终端打开(比如双击桌面图标),
PATH环境变量可能没透传,后续git命令会报“command not found”
git_command 路径填错,插件根本不会响应
插件装好后,必须告诉它本地 git.exe 在哪。路径不对,所有 Git::Add、Git::Commit 命令都会静默失败——没报错,但文件状态不变,也不弹提示。
正确做法是打开 Preferences → Package Settings → Git → Settings – User,填入绝对路径,例如:
{
"git_command": "D:\Git\cmd\git.exe"
}
注意:
- Windows 下路径用双反斜杠
\或正斜杠/,不能单反斜杠 - 别填
git-bash.exe或git-cmd.exe,只认git.exe - 如果系统环境变量已配好
git,也可直接写"git_command": "git",但前提是 Sublime 是从终端启动的(否则找不到)
push 失败常因 push.default 未设,不是账号或网络问题
执行 Git::Push 时卡住、无响应,或控制台报 “The current branch has no upstream branch”,大概率是 Git 本地配置缺了 push.default。
这个参数 Sublime 的 Git 插件无法传参,必须提前在命令行里设好:
git config --global push.default current
可选值有 nothing、matching、tracking、current、upstream,其中 current 最贴合日常使用:推当前分支到同名远程分支,不用每次指定 origin main。
顺手检查下全局用户信息是否已设,否则 commit 会用机器名和空邮箱:
git config --global user.name "yourname"git config --global user.email "you@example.com"
初始化仓库和提交流程,别跳过 git:init
打开一个空文件夹直接用 Git::Add 是无效的——插件检测不到 Git 仓库。必须先初始化:
- 按
Ctrl+Shift+P,输入Git::Init回车,会在当前文件夹生成.git目录 - 再用
Git::Add Current File或Git::Add All把文件加进暂存区 -
Git::Commit会弹出新标签页,第一行写提交信息,Ctrl+W关闭即提交(不保存=取消) - 最后
Git::Push推送,前提是已用git remote add origin xxx配好远程地址
远程地址得手动加:要么在终端里跑 git remote add origin git@github.com:user/repo.git,要么用插件命令 Git::Add Remote(部分版本支持),但别指望插件自动读取 GitHub 仓库页面的复制链接。
SSH 密钥没配好也会卡在 push,但错误更明确:控制台会打印 Permission denied (publickey)。这时候要确认 id_rsa.pub 已添到 GitHub 的 SSH Keys 设置里,且 ssh -T git@github.com 能返回成功提示。











