sublime git插件必须安装wbond版本，通过package control搜索“git”并认准作者wbond及“command-line git integration”描述；安装后需在含.git/的项目根目录打开文件夹，且系统path中git命令必须可用，否则报“git not found”。
Sublime 本身不带 Git，装了插件也不等于能用——90% 的失败都卡在 git 命令找不到或当前文件不在仓库里。
Git 插件必须装 wbond 版本，别选错名字
Package Control 里搜 “Git”，顶部显示作者是 wbond、描述含 “command-line git integration” 的那个才是。其他名字相似的比如 SublimeGit、SideBarGit、GitSavvy 要么停更、要么功能残缺、要么和它冲突。装错后右键没 Git 菜单、Ctrl+Shift+P 搜不到 Git: Status，不是环境问题，是根本没装对。
- 安装路径：按
Ctrl+Shift+P→ 输入Package Control: Install Package→ 回车 → 搜Git→ 点击Git（wbond） - 装完不重启，但必须打开一个含
.git/目录的文件夹（File → Open Folder…），单个文件或子目录下打开无效 - 验证是否生效：按
Ctrl+Shift+P输入Git: Status，能执行并返回状态才说明插件激活成功
“Git not found” 错误只说明一件事：Sublime 没读到你的 git
插件不自带 git，只调系统 PATH 里的可执行文件。终端能跑 git --version ≠ Sublime 能——尤其 macOS 和 Linux 桌面启动时 PATH 经常被截断。
- Windows：重装
Git for Windows，务必勾选Add Git to the system PATH；已装错就运行where git看路径，再填进设置 - macOS：Homebrew 安装的
git默认在/opt/homebrew/bin/git，GUI 启动 Sublime 不加载 shell 配置；解决方法二选一：open -a "Sublime Text"从终端启动，或在Preferences → Package Settings → Git → Settings – User里写死："git_command": "/opt/homebrew/bin/git" - Linux：桌面启动常丢
$PATH，建议用终端执行subl .；或改sublime-text.desktop的Exec=env PATH=$PATH subl %F
常用操作靠命令面板，快捷键只在仓库内有效
所有命令都基于当前文件路径向上找最近的 .git/，不在仓库里快捷键灰显、右键无菜单，不是 bug，是插件主动禁用。
-
Git: Status（Ctrl+Shift+G）：输出类似git status的结果，点击文件可跳转；支持Enter选中后按s暂存、u撤销、d查 diff -
Git: Add（Ctrl+Shift+H）：对当前文件执行git add <file></file>；在侧边栏多选文件后右键也能批量加 -
Git: Commit（Ctrl+Shift+K）：弹出输入框，写完直接提交；换行用Shift+Enter，不支持-a或--amend -
Git: Diff（Ctrl+Shift+D）：对比工作区 vs 暂存区；要看历史版本差异得用Git: Browse Repository
中文乱码、less 报错、push 失败这些都不是插件问题
它们都源于 Git 自身配置和 Sublime 运行环境的错位。
- 提交信息中文乱码或
fatal: cannot run less: No such file or directory：关掉 Git pager：git config --global pager.log false（Sublime 日志面板不依赖外部 pager） -
git push报错要求设置push.default：执行git config --global push.default matching（旧版 Git 默认值，新版默认simple，但插件未适配） - SSH 连接 GitHub 失败：和插件无关，得自己生成密钥、把
id_rsa.pub内容贴进 GitHub 的SSH and GPG keys设置页
最常被忽略的一点：插件不会自动识别你项目在哪。它只认当前打开的文件路径是否能“触达”.git/——哪怕整个项目都在你硬盘上，只要没用 Open Folder 选中含 .git 的根目录，它就当不存在。
