sublime text 的 git 功能需同时满足三条件：安装 wbond 官方 git 插件、通过 open folder 打开含 .git 的项目根目录、系统 git 命令在 path 中或手动配置 git_command 路径；缺一则命令灰显、右键无菜单或报“git not recognized”错误。
Sublime Text 本身不带 Git，装插件 ≠ 能用 Git；真正起作用的是你系统里装的 git 命令能否被 Sublime 正确调用，以及当前打开的路径是否在有效仓库内。
Git 插件装不上去？先看 Package Control 在不在
没它，Package Control: Install Package 根本不会出现在命令面板里。按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输这个命令没反应，说明 Package Control 没装好。
- 去
https://packagecontrol.io/installation复制对应 Sublime Text 版本的 Python 安装代码 - 在 Sublime 里按
Ctrl+`打开控制台，粘贴执行 - 重启 Sublime，再试一次命令面板
装哪个 Git 插件？只认 wbond 的官方 Git
搜索 “Git” 时会出现多个结果，但只有作者是 wbond、描述含 command-line git integration 的那个才是真插件。其他都别碰：
-
GitGutter：只画绿/蓝/红线，不能提交、推送 -
SideBarGit：功能残缺，右键菜单经常失效 -
SublimeGit：2015 年已停更，不兼容 Sublime Text 4+
装完后，必须用 File → Open Folder… 打开含 .git/ 目录的项目根目录——双击单个文件或打开子目录（如 /src/），插件直接“隐身”。
GInstall OneClick — 一键安装 GitHub 项目：规划、克隆、安装 Node 依赖、运行开发脚本。适用于想要获取 GitHubNode.js 项目的用户。
Git: Status 灰显或报 “git is not recognized”？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 后分支名还显示 main*？这不是 bug
插件只转发命令，不监听文件变化、不缓存状态、不自动刷新 UI：
- 右键无菜单 = 当前编辑的文件路径向上找不到
.git/目录（哪怕侧边栏显示的是项目根目录） - 状态栏分支名不变 = 插件不会主动轮询，需手动执行
Git: Status或切个标签页触发重绘 -
Git: Stash后想恢复？只能走命令面板：Git: Stash Pop（恢复并删掉）或Git: Stash Apply（恢复但保留），没有快捷键，右键也调不出来
最常被忽略的一点：插件完全不认 .sublime-project 文件，也不管你是不是从终端 cd 进来的——它只认当前文件路径 + 向上逐级查找 .git/ 这一套硬逻辑。
