gitsavvy要求系统已安装并配置好命令行git,而非仅gui工具;必须通过package control以全名“gitsavvy”安装,不可手动复制git_savvy.py;安装后需重启sublime text,快捷键ctrl+shift+h(或cmd+shift+h)应能打开git状态面板。

GitSavvy 要求 Git 命令行已就绪,不是装了 Git GUI 就够用
GitSavvy 本质是调用系统 git 可执行文件,它不自带 Git 运行时。如果你只装了 GitHub Desktop 或 GitKraken 这类带 GUI 的工具,git 命令很可能不在 $PATH 里,Sublime 启动后会报错 Git not found 或弹窗提示“Git executable not found”。
解决方法很简单:
- 去 git-scm.com/download/win(Windows)或 git-scm.com/download/mac(macOS)下载并安装官方 Git,勾选 “Add Git to PATH”(Windows)或确认安装时启用 shell command(macOS)
- 终端里运行
which git(macOS/Linux)或where git(Windows),确认返回有效路径,比如/usr/local/bin/git或C:Program FilesGitingit.exe - 重启 Sublime Text —— 它不会自动重载环境变量
Package Control 安装 GitSavvy 必须用全名 GitSavvy,大小写敏感
在 Sublime 的 Command Palette(Ctrl+Shift+P / Cmd+Shift+P)里输入 “Install Package”,进入 Package Control 后,搜索关键词必须是准确的 GitSavvy,而不是 git savvy、gitsavvy 或 Git Savvy。大小写错误或空格会导致搜不到或装错旧分支(比如过时的 GitSavvy-legacy)。
装完后,快捷键 Ctrl+Shift+H(Windows/Linux)或 Cmd+Shift+H(macOS)应能直接唤出 Git status 面板。如果没反应,说明没装成功或被其他插件冲突屏蔽。
git_savvy.py 不是手动放插件目录的文件,别从 GitHub 直接拖 .py
新手容易把 GitSavvy 仓库里的 git_savvy.py 单独复制进 Packages/User/ 或 Packages/GitSavvy/,这是无效的。GitSavvy 是一个完整插件包,含多个 Python 模块、sublime-settings、sublime-commands 和资源文件,依赖内部相对导入(如 from .core.git_command import GitCommand)。手动丢一个文件进去,Sublime 会报 ImportError: attempted relative import with no known parent package。
部署一个包含 4 个智能体(agent)的数字孪生平台。在以下情况下使用该技能: 1. 用户希望为物理资产监控与预测性维护等场景搭建数字孪生系统……
唯一推荐方式就是通过 Package Control 安装;若需开发调试,应 clone 整个仓库到 Packages/GitSavvy/ 并确保结构完整(含 __init__.py、core/、common/ 等子目录)。
配置 git_path 是绕过 PATH 问题的兜底方案,但优先级低于系统 PATH
如果因环境隔离(如 WSL、Docker Desktop、某些 IDE 自带终端)导致 Sublime 找不到 git,可在 Sublime 的 Preferences → Package Settings → GitSavvy → Settings 里显式指定:
{
"git_path": {
"windows": "C:\Program Files\Git\bin\git.exe",
"osx": "/opt/homebrew/bin/git",
"linux": "/usr/bin/git"
}
}
注意两点:
-
git_path是对象,不是字符串;不同系统用不同 key,不能只写"git_path": "/usr/bin/git" - 路径中反斜杠 Windows 下要双写(
\),或改用正斜杠(C:/Program Files/Git/bin/git.exe)更安全
这个配置只在找不到系统 git 时生效,不是覆盖逻辑 —— 如果 PATH 里已有 git,GitSavvy 仍会优先用它。
真正卡住的人,往往卡在 Git 命令行没就位,或者装了插件却没重启编辑器。其余配置都是锦上添花,先让 Ctrl+Shift+H 能拉出状态面板,再谈分支操作、rebase 可视化或自定义快捷键。










