Git插件需同时满足三个硬性条件：官方wbond版本、通过Open Folder打开含.git/的项目根目录、系统git在PATH中或显式配置git_command；缺一则命令灰显、右键无菜单、“Git not found”报错。
Git 插件不是“装上就能用”，它依赖三个硬性条件同时满足：插件本身是 wbond 维护的官方版本、Sublime 必须通过 Open Folder 打开含 .git/ 的项目根目录、系统 git 命令必须在 PATH 中或显式配置路径。缺一就会出现命令灰显、右键无菜单、“Git not found”报错。
确认 Package Control 已就位
没它，Git 插件根本装不了。按 Ctrl+Shift+P（Windows/Linux）或 Command+Shift+P（macOS）调出命令面板，输入 Package Control: Install Package 并回车——如果提示“command not found”，说明 Package Control 没装好或版本不匹配（Sublime Text 4 需要 Package Control 4.x）。去 packagecontrol.io/installation 复制对应版本的安装代码，粘贴进 Sublime 的 View → Show Console 执行。
只装 wbond 官方 Git 插件，别选错
命令面板中输入 Package Control: Install Package → 等列表加载完 → 输入 Git → 在结果里只选那个作者是 wbond、描述含 command-line git integration 的条目。别点 GitGutter（只画绿线）、SideBarGit（功能残缺）、SublimeGit（2015 年停更，不兼容 ST4）。
装完不用重启，但得确保当前窗口是用 File → Open Folder… 打开的完整项目目录，且侧边栏顶部路径下存在 .git/ 文件夹；否则右键菜单不会出现 Git 子项，Ctrl+Shift+P 里搜 Git: Status 也会灰显。
用大白话操作当前项目的 Git/GitHub——配置 GitHub（装 gh CLI + 登录 + 建仓库）、备份、拉取下载、查询历史、回滚代码、管理分支。当用户用日常语言表达 git 意图时触发（例如"git备份一下""git下载项目""git拉下来""git看看我改了啥""git回退到上一个版本""git新建个分支搞新功能""git合并到主分支""git
解决 “Git not found” 错误
这个错误和插件无关，是 Sublime 找不到系统 git 可执行文件。终端里能跑 git --version ≠ Sublime 能继承同一环境：
- macOS：GUI 启动时 PATH 默认只有
/usr/bin，Homebrew 安装的git在/opt/homebrew/bin/git就会被忽略。要么从终端运行open -a "Sublime Text"，要么手动配置：Preferences → Package Settings → Git → Settings – User，填入：{"git_command": "/opt/homebrew/bin/git"} - Windows：重装 Git for Windows，务必勾选
Add Git to the system PATH（推荐选 “Use Git from Windows Command Prompt”）；已装错就先在 CMD 里运行where git看路径，再填进上面的git_command配置。 - Linux：桌面启动常丢
$PATH，建议终端执行subl .；或改sublime-text.desktop的Exec=行为：Exec=env PATH=$PATH subl %F
验证是否真正可用
打开一个已有 .git/ 的项目文件夹后：
- 右键任意文件或空白处，应出现
Git → Add、Git → Commit等菜单 -
Ctrl+Shift+P输入Git: Status应立即弹出状态窗口，列出未暂存/已暂存文件 - 快捷键
Ctrl+Shift+G（Windows/Linux）或Command+Shift+G（macOS）应等效于触发Git: Status
如果以上任一不成立，问题一定出在仓库路径识别或 git_command 配置上，而不是插件本身。最容易被忽略的是：你双击打开的只是一个 .js 文件，而不是整个项目文件夹——这种情况下插件压根不会激活。
