gitsavvy需在含.git的项目根目录下通过file→open folder打开，并确保git命令行可用且路径正确配置，否则功能灰显。
Sublime Text安装GitSavvy插件后无法操作Git命令，不是插件没装成功，而是它根本没识别到你的本地Git仓库——GitSavvy只在明确上下文里激活功能，错一步就全程灰显、报错或面板空白，连状态都打不开。
确认Git CLI已就位
打开终端（macOS/Linux）或命令提示符（Windows），输入 git --version 并回车。必须看到类似 git version 2.40.1 的输出，否则GitSavvy连底层命令都调不动。
如果报“command not found”或“不是内部或外部命令”，说明系统没装Git，或PATH没配好——先去官网下载安装Git，勾选“Add Git to PATH”选项（Windows）或用Homebrew安装（macOS：brew install git）。
以正确方式打开项目文件夹
这一步卡住90%的新手：双击打开单个文件（如index.html）→ GitSavvy完全静默；右键→“用Sublime Text打开”子目录（如src/）→ 同样无效。
【必须通过 File → Open Folder… 菜单，选择含 .git/ 子目录的最外层项目根目录】。例如你的仓库结构是 /Users/me/my-project/.git/，那就选中 my-project 文件夹，而不是它里面的 my-project/src 或 my-project/src/index.html。
打开后，观察左下角状态栏——若显示分支名（如 main 或 feature/login），说明上下文已激活；若无任何Git信息，说明没开对位置。
修复Git路径继承问题（macOS/Linux常见）
终端能跑 git --version，但Sublime里仍报 "git" is not recognized？大概率是GUI启动方式没继承shell环境变量。
方法一：从终端启动Sublime（推荐）
macOS：执行 open -a "Sublime Text" /path/to/my-project
Linux：执行 subl /path/to/my-project
方法二：硬编码Git路径
按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS）→ 输入 GitSavvy: Settings – User → 回车
在打开的JSON配置文件中，插入这一行（注意逗号）："git_path": {"osx": "/opt/homebrew/bin/git"}（macOS Homebrew安装）"git_path": {"windows": "C:\Program Files\Git\bin\git.exe"}（Windows，反斜杠必须双写）
【改完保存，必须重启Sublime Text，设置才生效】
验证GitSavvy是否真正就绪
第一步：按 Ctrl+Shift+G（Win/Linux）或 Cmd+Shift+G（macOS）尝试打开状态面板。
第二步：若弹出空白面板或报 No git repository found，立刻检查前三个步骤——80%是开错目录或路径没继承。
第三步：若面板正常列出修改/未跟踪文件，把光标移到任一文件名上，按 a 尝试暂存——有反应说明全部通了。
