Sublime Text 通过官方 Git 插件实现轻量 Git 集成，需本地安装 Git 并正确配置 PATH；插件支持常用操作如 Add、Commit、Diff 等，但依赖仓库根目录、不支持复杂工作流，高级命令需手动配置参数。
Sublime Text 本身不内置 Git 集成，但通过插件 Git（官方维护）可直接调用系统 Git 命令，在侧边栏、命令面板或右键菜单中执行常用操作。前提是本地已安装 Git 并配置好环境变量。
确认系统 Git 是否可用
Sublime 的 Git 插件依赖命令行 git 可执行文件。如果终端能运行 git --version，但 Sublime 里报错 Git not found，大概率是 Sublime 没读到你的 shell 环境 PATH。
-
macOS：检查是否用的是 LaunchServices 启动 Sublime（如 Spotlight 或 Dock），它默认不加载
~/.zshrc或~/.bash_profile；推荐从终端运行subl .启动项目 - Windows：确保 Git 安装时勾选了 “Add Git to PATH”，且 Sublime 不是以“兼容模式”或低权限运行
- Linux：验证
which git输出路径，必要时在 Sublime 的Preferences → Package Settings → Git → Settings中手动指定"git_command": "/usr/bin/git"
安装并启用 Git 插件
使用 Package Control 安装后，无需额外启用——只要当前打开的文件夹是 Git 仓库（含 .git 目录），插件会自动激活。
- 快捷键
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Package Control: Install Package回车 - 搜索
Git，选择官方插件（作者sublimetext-plugins，不是GitGutter或其他衍生版） - 安装完成后重启 Sublime（部分版本需重启才生效）
常用 Git 操作怎么触发
所有操作都基于当前编辑的文件或所选文件夹是否在 Git 仓库内。不支持跨仓库或多根目录统一提交。
- 右键文件 → 出现
Git子菜单：可执行Add、Commit、Diff、Revert等 - 右键侧边栏文件夹 →
Git: Status：快速查看未暂存/已暂存文件列表 - 快捷键
Ctrl+Shift+H（Win/Linux）或Cmd+Shift+H（macOS）：唤出 Git 命令面板，输入commit、push、pull等关键词过滤 - 提交时弹出的临时 buffer 支持多行输入，保存即触发
git commit -m "..."；若想加-v或--no-verify，需修改插件设置里的"git_commit_args"
为什么有些命令不出现或报错
不是所有 Git 命令都默认暴露在 UI 中，比如 rebase、stash、cherry-pick 需要手动调用或绑定快捷键。另外，插件对 Windows 路径空格、中文路径、WSL2 下的 repo 路径兼容性较弱。
- 遇到
fatal: not a git repository：确认当前窗口打开的是仓库根目录，而不是子目录（除非子目录下也有独立.git） -
Commit按钮灰掉：说明没有文件被git add，先右键文件选Git: Add，或用命令面板运行Git: Add All - 想用
git push --force-with-lease：插件默认只支持基础 push；需在用户设置中添加"git_push_args": ["--force-with-lease"]
真正卡住的地方往往不是功能有没有，而是 Sublime 拿不到正确的 Git 环境，或者误以为它能替代桌面客户端——它只是轻量封装，复杂工作流（如交互式 rebase、 submodule 管理）仍得切到终端。
