必须先装好Package Control，再装wbond官方Git插件，且系统git命令必须能被Sublime正确调用；三者缺一，Git功能不可用。Package Control未生效则命令面板无Install Package选项；仅wbond插件支持完整Git命令；必须通过Open Folder打开含.git的项目根目录；git not recognized多因PATH未透传，需手动配置git_command路径。
必须先装好 Package Control，再装 wbond 官方 Git 插件，且系统 git 命令必须能被 Sublime 正确调用——三者缺一，Git 功能就不可用。
Package Control 没装好，Git 插件根本装不上
Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS）调不出命令面板，或输入 Package Control: Install Package 没反应，说明 Package Control 未生效。常见原因有：
- Data 文件夹不存在、拼写错误（比如
data或DATA），或没和sublime_text.exe（或 macOS/Linux 下的可执行文件）同级 - 已误启动过 Sublime，导致配置写入了
%APPDATA%\Sublime Text或~/Library/Application Support/Sublime Text；需先删掉对应目录再重试 - 用了旧版 Python 2 脚本（含
urllib2），Sublime Text 4 只支持 Python 3.3+；务必用官网最新安装代码 - 执行后控制台报
Error validating download：不是脚本错，而是网络中间设备篡改了下载内容；此时应手动下载Package Control.sublime-package，放进Data/Installed Packages/目录再重启
只认 wbond 的官方 Git 插件，别碰其他“Git”名字的
在 Package Control 中搜 Git，结果里会出现多个插件，但只有作者是 wbond、描述含 command-line git integration 的那个才是真 Git 插件。其余都不可靠：
-
GitGutter：只画状态标记（绿/蓝/灰线），不能提交、推送、切换分支 -
SideBarGit：右键菜单常失效，git stash后分支名不更新，状态栏也不刷新 -
SublimeGit：2015 年停更，不兼容 Sublime Text 4+
装完后，务必通过 File → Open Folder… 打开含 .git/ 子目录的项目根目录——双击单个文件、或打开子目录（如 /src）会导致插件完全不加载。
git not recognized？不是没装 git，是 Sublime 没继承 PATH
终端里能跑 git --version ≠ Sublime 能调用它。GUI 启动方式默认不加载 shell 配置，PATH 经常被截断：
- macOS：在
~/.zprofile里加export PATH="/opt/homebrew/bin:$PATH"（Homebrew 路径），然后执行killall Dock - Windows：重装 Git for Windows，务必勾选
Add Git to the system PATH；若已装错，手动把C:\Program Files\Git\cmd加进系统环境变量 - Linux：桌面快捷方式常丢
$PATH，建议终端执行subl .；或修改sublime-text.desktop的Exec=行为：改为Exec=env PATH=$PATH subl %F - 实在不行，就手动配
git_command：菜单Preferences → Package Settings → Git → Settings – User，填{"git_command": "/usr/local/bin/git"}（路径以which git或where git输出为准）
右键无 Git 菜单、状态栏不更新、stash 后还显示 m
这些现象本质都是同一个问题：当前视图没绑定到有效 Git 仓库。验证方法很简单：
- 菜单
Tools → Git是否展开？如果整个菜单灰显或不存在，说明插件没识别到仓库 - 状态栏最右侧是否显示分支名（如
main）？没显示 = 当前没在 Git 根目录下 - 右键菜单里有没有
Git: …项？没有 = 要么没装对插件，要么路径不对
最容易被忽略的一点：U 盘或移动硬盘用 FAT32 格式时，不支持长文件名和符号链接，某些插件（如 GitGutter）可能无法加载——便携版务必用 exFAT 或 NTFS 格式。
