gitsavvy需手动配置git_path、以含.git目录的根目录打开项目、重启sublime后才生效；命令灰显或无响应均因三者未同时满足，其严格复刻git命令行行为，不绕过任何git原生命令约束。
GitSavvy 不是开箱即用的 Git 图形界面，它严格复刻命令行行为——装对、配对、开对目录，三者缺一不可，否则所有命令都灰显或报 No git repository found。
git: status 始终没反应？先确认这三件事
这不是插件坏了，是 GitSavvy 根本没连上你的 git 命令行工具。它不读 shell 的 PATH，也不猜路径，全靠你手动填准。
- 终端执行
git --version，有输出才算 Git CLI 真实可用 - 用
which git（macOS/Linux）或where git（Windows）查真实路径，比如/opt/homebrew/bin/git或C:/Program Files/Git/bin/git.exe - 进
Preferences → Package Settings → GitSavvy → Settings，右侧用户配置加这段（注意字段名必须是"git_path"，不是"git_binary"）：
"git_path": {
"osx": "/opt/homebrew/bin/git",
"windows": "C:/Program Files/Git/bin/git.exe",
"linux": "/usr/bin/git"
}
改完保存后，必须重启 Sublime Text，否则设置不生效。
为什么命令面板里搜不到 git: status？
GitSavvy 只在满足全部条件时才加载命令：以含 .git/ 的文件夹方式打开项目（不是单个文件，也不是子目录如 src/），且 git_path 配置正确、Sublime 能调用到 git。
- 务必通过
File → Open Folder…打开最外层项目根目录（里面直接有.git/） - macOS 用户若双击图标启动 Sublime，常因 GUI 环境无法继承 shell
PATH，建议从终端运行open -a "Sublime Text" - 命令面板输入
GitSavvy: Status或git: status，如果灰显或报错，说明前两项至少有一项失败，别查快捷键绑定
执行 git: push 报 “no upstream branch” 怎么办？
这不是错误，是首次推送 feature 分支的正常现象。GitSavvy 不自动设 upstream，它原样复刻 git push 行为。
- 确保已在目标分支（如
feature/login-ui）上，且已提交过至少一次 - 按
Ctrl+Shift+P输入git: push→ 选Push current branch - 若弹出提示说
no upstream，直接回车确认 —— GitSavvy 会自动补上--set-upstream origin feature/login-ui - 之后再用普通
git: push就能一键推了
状态面板里按 a / s / c 没反应？光标位置很关键
GitSavvy 的状态视图默认只列出「有变更」的文件；刚 clone 完仓库却没改任何东西，面板就是空的——这正常，不是 bug。
- 按
Ctrl+Shift+G（Win/Linux）或Cmd+Shift+G（macOS）打开状态面板后，光标必须落在某文件名上才能触发a（add）、s（stage）、c（commit）等快捷键 - 暂存后，按
c进入 commit 编辑区，写完 message 后，必须按Ctrl+Enter（Win/Linux）或Cmd+Enter（macOS）提交；普通Enter只换行，不触发提交 - 如果想批量暂存，先按
Ctrl+A全选文件，再按s，比逐个点更稳
最容易被忽略的是：GitSavvy 不会帮你绕过 Git 本身的规则，比如未配置 user.name/user.email 就无法提交，它会静默失败或弹窗报错；这些底层约束，得靠你自己在终端跑 git config --global user.name "xxx" 补全。
