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 —— 插件不会帮你做这些判断。
