Sublime Text 需依赖系统 Git 命令，安装 Git 插件（如 wbond 维护的 Git）仅提供图形化操作入口；必须先确保 git 在终端可用，再通过 Package Control 安装插件，最后手动执行状态查看、添加、提交、推送等原子操作。
Sublime Text 本身不内置 Git 支持，也不能直接“安装 Git 插件同步代码”——Git 是命令行 工具，Sublime 只能通过插件调用它。关键不是“装个插件就能自动同步”，而是让 Sublime 能调用你系统已安装的 git 命令，并提供图形化操作入口。
确认系统已正确安装并配置 git
这是所有后续操作的前提。Sublime 的 Git 插件（如 Git 或 SideBarGit）本质是调用你终端里能运行的 git 命令。如果终端输 git --version 报错或找不到命令，插件必然失效。
- macOS：推荐用
brew install git，避免 Xcode Command Line Tools 自带的老版本 - Windows：安装 Git for Windows 时务必勾选
Add Git to the system PATH（否则 Sublime 找不到git.exe） - Linux：用包管理器安装（如
sudo apt install git），确保git在$PATH中 - 验证方式：打开终端 / 命令提示符，执行
git --version和which git（macOS/Linux）或where git（Windows）
安装官方 Git 插件（Package Control → Git）
这是最轻量、最稳定的选择，由 wbond 维护，直接绑定系统 git 命令，不封装逻辑，出问题容易定位。
- 确保已安装
Package Control（没装就先搜“sublime package control install”） - 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Package Control: Install Package回车 - 搜索
Git，点击安装（注意名字就是纯Git，作者 wbond） - 安装后重启 Sublime，打开一个已
git init或克隆好的项目文件夹
此时右键文件或文件夹，会出现 Git 子菜单；按 Ctrl+Shift+P 输入 git 可唤出常用命令（如 Git: Status、Git: Add、Git: Commit）。
提交与推送操作流程（不是一键同步）
Sublime 的 Git 插件不会替你做分支切换、解决冲突或决定推送到哪个远程仓库。它只是把命令行操作搬到编辑器里，步骤必须手动走完：
- 查看状态：右键 →
Git: Status，或快捷键Ctrl+Shift+P→Git: Status，弹出面板显示未暂存 / 已暂存文件 - 添加文件：在
Git: Status面板中，光标移到文件上按A（add），或右键文件 →Git: Add - 写提交信息：按
Ctrl+Shift+P→Git: Commit，会打开新 tab 让你输入 commit message，保存即触发git commit -m "xxx" - 推送：必须先确保本地分支已关联远程（如
git branch --set-upstream-to=origin/main main），再执行Ctrl+Shift+P→Git: Push；若未关联，会报错fatal: The current branch main has no upstream branch.
注意：Git: Push 默认推当前分支到其 upstream，不支持交互式选择远程或分支。如需灵活推送，仍需切终端执行 git push origin feature/login。
常见失败原因和绕过方法
很多“点不动”“没反应”“报错找不到 git”的问题，根源不在插件本身：
-
Unable to find git binary：Sublime 没读到系统 PATH，尤其是 macOS Catalina+ 或 Windows 安装路径含空格时。可手动在插件设置里指定路径：Preferences → Package Settings → Git → Settings，填入"git_binary": "/usr/local/bin/git"（macOS）或"git_binary": "C:\Program Files\Git\bin\git.exe"（Windows） - 右键无
Git菜单：确认当前视图是项目根目录（即包含.git/文件夹的文件夹），且 Sublime 是以该文件夹为项目打开的（File → Open Folder……） -
Git: Commit保存后无反应：检查 commit message 文件是否以 UTF-8 无 BOM 编码 保存（Sublime 默认是这个，但粘贴内容可能带隐藏字符） - 想“自动同步”？别依赖插件。真要自动化，请用
git hooks或 CI 工具，Sublime 插件不该承担这个角色
Git 插件的价值在于快速触发原子操作，而不是替代你理解 Git 工作流。一旦遇到推送拒绝（non-fast-forward）、冲突或权限错误，最终还得回到终端看原始报错、执行 git pull --rebase 或 git push --force-with-lease —— 插件不会帮你做这些判断。
