sublime text 本身不带 git 功能，需调用系统 git 命令行工具；80% 失败源于 git 不可用、路径未配置或未在含 .git 的项目根目录打开。
Sublime Text 本身不带 Git 功能，所谓“编辑器内提交”，本质是让 Sublime 调用你本地已装好的 git 命令行工具。80% 的失败不是插件没装对，而是 git 找不到、路径没配好、或根本没在项目根目录打开。
确认系统 git 是否可用，且 Sublime 能调用它
这是所有操作的前提，跳过这步后面全卡住。
- 先在终端（Terminal / CMD / Git Bash）运行
git --version，必须返回类似git version 2.40.1的结果；不行就去 git-scm.com 下载安装，Windows 用户务必勾选 “Add Git to the system PATH” - Mac 用户如果用 Homebrew 安装了
git，但 Sublime 里仍报git: command not found，大概率是 GUI 启动时没继承 shell 的PATH；解决方法有两个：open -a "Sublime Text"从终端启动，或在Preferences → Package Settings → Git → Settings – User里硬编码路径，例如："git_command": "/opt/homebrew/bin/git"
- Windows 用户若手动指定路径，别填
git.exe，填C:\Program Files\Git\cmd\git.exe或更稳妥的C:\Program Files\Git\bin\git.exe
装对插件：只认 wbond 维护的官方 Git 插件
搜 “Git” 时会出来一堆名字相似的包，但只有作者是 wbond、描述含 “command-line git integration” 的那个才是官方持续维护的插件。装错就等于白忙。
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入Package Control: Install Package回车 - 等待列表加载完，输入
Git，选顶部显示作者为wbond的那个，**不是**GitSavvy、SublimeGit或SideBarGit - 装完重启 Sublime（尤其刚装完 Package Control 后）
- 验证是否生效：打开一个含
.git/的文件夹（File → Open Folder…），再按Ctrl+Shift+P输入Git: Status—— 如果命令可选且不灰显，说明插件已就位
提交代码的三步实操：add → commit → push
Git 插件不提供图形化暂存区界面，所有操作靠命令面板驱动，commit 和 push 都有隐藏交互细节。
-
Git: Add：右键文件或在命令面板里执行，把当前文件加到暂存区；支持多选后批量右键 -
Git: Commit：执行后会弹出一个临时 buffer，标题是Git Commit Message；这不是普通文本框——输完内容后必须按Ctrl+Enter（不是回车键）确认，否则关掉就丢弃 -
Git: Push：首次推送会失败，报错fatal: The current branch main has no upstream branch；这时要先执行Git: Push → Set upstream and push，选远程名（通常是origin）和分支名（如main） - 所有操作的输出都集中在底部面板（
Ctrl+`可呼出），Push 失败时一定要看这里，常见原因包括 SSH key 没配、远程 URL 是 HTTPS 且没存凭据、或网络策略拦截
容易被忽略的两个硬性前提
插件功能是否激活，完全取决于这两个条件是否同时满足——缺一不可。
- Sublime 必须通过
File → Open Folder…打开**整个 Git 仓库根目录**（即包含.git/文件夹的那层），打开单个文件或子目录下，右键菜单不会出现 Git 选项，命令面板里Git: *命令也会灰显 - 远程仓库推荐用 SSH 协议（
git@github.com:user/repo.git），避免 HTTPS 方式下每次 push 都弹窗输密码；没配过 SSH key 的话，ssh -T git@github.com应返回成功提示
真正卡住人的地方从来不是“怎么点菜单”，而是 git_command 路径写错、.git 目录没被识别、或者 commit 消息输完忘了按 Ctrl+Enter。这些点不检查，重装十遍插件也没用。
