Sublime Text 通过官方 Git 插件调用系统 Git 工具实现版本控制，前提是系统 PATH 中可执行 git 命令；需安装 Package Control 并从中安装 wbond 维护的 Git 插件，且文件必须位于 Git 仓库内才能使用状态查看、添加、提交、推拉等命令。
Sublime Text 本身不内置 Git 支持，但通过 Git 插件（官方插件，非第三方）可直接调用系统已安装的 Git 命令行工具完成常用操作。前提是你的系统 PATH 中能正确执行 git 命令——这是最关键的前置条件，否则插件会报错“Git not found”或命令无响应。
确认系统 Git 是否可用且路径正确
插件依赖外部 git 可执行文件，不会自带或下载 Git。如果终端里运行 git --version 报错或返回空，Sublime 的 Git 插件必然失效。
-
macOS：检查是否通过 Homebrew 安装（
brew install git），或 Xcode Command Line Tools 是否启用（xcode-select --install） - Windows：安装 Git for Windows 时务必勾选 “Add Git to the system PATH”；若已安装，重启 Sublime 或终端后运行
where git确认路径 - Linux：多数发行版默认带
git，如无则用包管理器安装（如sudo apt install git） - Sublime 内验证：按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Git: Status，若弹出错误提示“Git not found”，说明 PATH 未生效或 Git 未安装
安装官方 Git 插件（Package Control 方式）
Sublime 的 Git 插件由 wbond 维护，是 Package Control 库中唯一被广泛认可的原生 Git 集成方案。它不提供 GUI，而是把常用 Git 命令映射为快捷菜单项和命令面板操作。
- 确保已安装
Package Control（如未安装，访问https://packagecontrol.io/installation手动安装） - 按
Ctrl+Shift+P→ 输入Package Control: Install Package→ 回车 → 搜索Git→ 选择并安装Git（作者 wbond，不是GitGutter或SideBarGit） - 安装完成后无需重启，但需确保当前打开的文件/文件夹处于 Git 仓库内（即目录下有
.git/文件夹），否则大部分命令灰显不可用
常用操作与对应命令面板指令
插件不改变 Git 工作流，只是快捷触发命令。所有操作都在当前文件所在 Git 仓库上下文中执行，不支持跨仓库批量操作。
-
Git: Status— 查看暂存区与工作区状态，等价于git status；输出在 Sublime 新标签页中，支持点击文件跳转 -
Git: Add— 将当前文件加入暂存区（git add <file>）；若在文件夹视图中右键，可对多个文件批量执行 -
Git: Commit— 弹出输入框写提交信息，等价于git commit -m "..."；不支持-a或--amend等参数，需手动补全 -
Git: Push/Git: Pull— 直接推送到默认远程分支或拉取更新；要求本地分支已关联上游（git branch --set-upstream-to=origin/main main），否则报错“No upstream configured” -
Git: Diff— 显示当前文件未暂存的改动（git diff -- <file>），以高亮色块呈现差异
容易忽略的限制与调试技巧
这个插件轻量、稳定，但设计上就是“命令行封装”，没有状态感知、分支图形化或冲突可视化能力。很多看似该有的功能其实不在它的职责范围内。
- 不自动刷新状态：修改文件后，
Git: Status不会自动更新，需手动再执行一次 - 不支持子模块、rebase 交互式操作、stash 管理等高级命令；这些必须切到终端执行
- 中文路径或含空格路径一般没问题，但如果
git配置了别名（如co = checkout），插件无法识别，所有命令都走原生命令字面量 - 调试插件行为：打开 Sublime 控制台（
Ctrl+`），执行任意 Git 命令后观察输出，可看到实际调用的 shell 命令和 stderr 错误（比如权限拒绝、认证失败）
真正卡住的点往往不是插件装没装好，而是 Git 本身没配通，或者当前目录根本不在仓库里。先在终端里把 git status 和 git push 跑通，再回到 Sublime，基本就不会有意外了。
