Sublime Text 本身不带 Git 功能，需依赖系统 git 命令行工具和 wbond 官方 Git 插件；必须先确认终端中 git --version 可运行、手动配置 git_command 路径、以项目根目录（含 .git）打开，再依次执行 Git: Add、Git: Commit、Git: Push（首次需设 upstream），且推荐使用 SSH 协议连接 GitHub。
Sublime Text 本身不带 Git 功能，所谓“直接提交到 GitHub”，本质是让 Sublime 调用你本地已安装的 git 命令行工具，并配合 SSH 或 HTTPS 认证完成推送。80% 的失败都卡在 git 找不到、路径配错、或没从项目根目录打开——不是插件装得不对，而是环境没就绪。
确认系统 git 是否可用，且 Sublime 能调用它
这是最常被跳过的一步，但所有后续操作都依赖它。
- 在终端（不是 Sublime 控制台）运行
git --version，必须返回类似git version 2.40.1；否则先去 git-scm.com 安装 - Windows 用户用
where git查路径，常见为C:/Program Files/Git/cmd/git.exe（注意反斜杠要双写或改用正斜杠） - macOS 用户若用 Homebrew 安装，
which git返回/opt/homebrew/bin/git，但双击图标启动的 Sublime 看不到该路径——必须手动指定 - 打开
Preferences → Package Settings → Git → Settings – User，填入：{ "git_command": "/opt/homebrew/bin/git" } - 验证是否生效：按
Ctrl+`打开 Sublime 控制台，输入import subprocess; subprocess.run(['git', '--version'])，有输出即成功
只装官方维护的 Git 插件，别碰 GitSavvy 或 SublimeGit
Sublime 官方生态中唯一持续适配 Sublime 4、稳定调用系统 git 的插件叫 Git，作者 wbond。装错名字，命令面板就搜不到 Git: Status。
- 按
Ctrl+Shift+P输入Package Control: Install Package，回车后搜Git，只选顶部显示作者为wbond、描述含command-line git integration的那个 - 别装
GitSavvy（逻辑完全不同，和Git插件冲突） - 别装
SublimeGit（多年未更新，Sublime 4 上基本不可用，常报git: command not found） - 装完不用重启，但必须用
File → Open Folder…打开一个含.git/目录的项目根目录——单个文件或子目录下打开，插件不会激活
从 add 到 push：每步都不能省，且顺序不能乱
这个插件不隐藏 Git 工作流，add → commit → push 必须分步执行。它不自动识别未暂存文件，也不默认提交全部改动。
- 先看状态：按
Ctrl+Shift+P输入Git: Status，弹出只读面板——灰色是未暂存（modified/untracked），绿色是已暂存（staged） - 暂存文件：光标放在灰色文件名上，按
Ctrl+Shift+P → Git: Add File；或右键文件 →Git → Add File - 提交：再运行
Git: Commit，会弹出新标签页让你写commit message，保存即提交到本地仓库（注意：仅本地） - 推送：最后运行
Git: Push才真正发到远程。首次推送需先设 upstream：Git: Push with Options→ 勾选set upstream - 如果
push报错提示push.default未设置，回到终端运行：git config --global push.default matching
SSH 连接 GitHub 是关键，HTTPS 方式容易卡在密码输入
Sublime 的 Git 插件调用的是命令行 git，所以它走什么协议，完全取决于你本地仓库的 remote URL。HTTPS 方式在推送时会弹 GUI 密码框（Sublime 不处理），导致卡住；SSH 才是可靠选择。
- 生成密钥：终端运行
ssh-keygen -t rsa -C "your_email@example.com"，连按三次回车用默认路径 - 添加密钥到 ssh-agent：
eval "$(ssh-agent -s)"，然后ssh-add ~/.ssh/id_rsa - 复制公钥：
cat ~/.ssh/id_rsa.pub | pbcopy（macOS）或用文本编辑器打开并全选复制 - 登录 GitHub →
Settings → SSH and GPG keys → New SSH key，粘贴、保存 - 验证连接：
ssh -T git@github.com，看到Hi username! You've successfully authenticated...即成功 - 确保本地仓库 remote 是 SSH 地址：
git remote set-url origin git@github.com:username/repo.git
最容易被忽略的其实是项目打开方式和 SSH 配置——插件能跑起来，不代表能推上去。很多“提交失败”其实只是 Sublime 没从 .git/ 所在目录启动，或者 remote 还是 HTTPS 地址，一推就卡在认证环节。
