Sublime Text 本身不内置 Git 功能，需通过 wbond 维护的官方 Git 插件调用系统 git 命令行工具；前提是系统 PATH 中 git 可执行（终端运行 git --version 成功），且 Sublime 必须从含 .git/ 的项目根目录打开才能激活插件功能。
Sublime Text 本身不带 Git 功能，所谓“配置 Git 插件”，本质是让 Sublime 能调用你系统里已安装的 git 命令行工具。如果 git --version 在终端跑不通，或者 Sublime 找不到 git，后面所有操作都会卡在第一步。
确认系统 git 是否可用且路径可被 Sublime 读取
这是最常被跳过的一步，但 80% 的“插件不生效”问题都出在这儿。
- 在终端（不是 Sublime 控制台）运行
git --version，必须返回类似git version 2.40.1；否则先去 git-scm.com 下载安装，Windows 用户务必勾选 Add Git to the system PATH - macOS 用户若用 Homebrew 安装过
git，终端里which git返回/opt/homebrew/bin/git，但双击图标启动 Sublime 时它看不到这个路径——必须手动指定：
打开 Preferences → Package Settings → Git → Settings – User，填入：{ "git_command": "/opt/homebrew/bin/git" } - Windows 用户可运行
where git确认路径，常见为C:\Program Files\Git\cmd\git.exe，同样写进上面的Settings – User中（注意反斜杠要双写或改用正斜杠） - 验证 Sublime 是否真能调用：按
Ctrl+`打开控制台，输入import subprocess; subprocess.run(['git', '--version'])
，有输出即成功
安装正确的 Git 插件（不是 GitSavvy，也不是 SublimeGit）
Sublime 官方生态中唯一持续维护、适配 Sublime 4 的 Git 插件叫 Git，作者是 wbond。装错名字，命令面板就搜不到 Git: Status。
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Package Control: Install Package回车 - 等待列表加载后，搜索
Git，只选顶部显示作者为wbond、描述含command-line git integration的那个 - 别装
GitSavvy（逻辑完全不同，和Git插件冲突）、也别装SublimeGit（多年未更新，Sublime 4 上基本不可用） - 装完不用重启，但必须确保当前窗口是从 File → Open Folder… 打开的、包含
.git/目录的项目根目录——单个文件或子目录下打开，插件不会激活
从暂存到提交：完整流程与关键细节
这个插件不隐藏 Git 工作流，add → commit → push 必须分步执行，漏一步就推不上去。而且它不自动识别未暂存文件，也不默认提交全部改动。
- 先看状态：按
Ctrl+Shift+P输入Git: Status，会弹出只读面板，灰色文件是未暂存（modified/untracked），绿色是已暂存（staged） - 暂存文件：光标放在灰色文件名上，按
Ctrl+Shift+P→Git: Add File；或右键文件 →Git → Add File；想批量暂存，可在侧边栏多选后右键 - 写提交信息：按
Ctrl+Shift+K（默认快捷键），弹出输入框；第一行是 summary，建议 ≤50 字；空一行后是 body；换行用Shift+Enter（不是Enter） - 提交仅到本地仓库：输完直接按
Enter即触发git commit -m；不支持-a或--amend，需手动补全参数（比如想跳过暂存直接提交所有，得用终端跑git commit -am "msg"）
推送前必须设 upstream，否则报 fatal: The current branch main has no upstream branch
插件的 Git: Push 就是直译 git push，不做任何默认分支关联。首次推送不手动设 upstream，必定失败。
- 按
Ctrl+Shift+P输入Git: Push with Options，回车后勾选 set upstream，再点 OK - 后续再推，直接
Git: Push就行（快捷键Ctrl+Shift+U） - 如果报
rejected - non-fast-forward，说明远程有新提交：先Git: Pull，解决冲突（冲突文件侧边栏变红，打开后删掉<<<<<<和>>>>>>标记并保留正确内容），再Git: Add File+Git: Commit，最后Git: Push - 中文 commit message 乱码？关掉 Git 的 pager：
git config --global pager.log false（插件日志面板不依赖外部 pager）
最容易被忽略的是：插件只认「当前编辑文件路径向上查找能碰到 .git/」这个硬规则。哪怕你 Sublime 里加了十个项目文件夹，只要没从含 .git 的根目录打开，所有 Git 命令都是灰的——这不是 bug，是设计如此。
