Sublime Text 中不存在官方支持或持续维护的 GitLog 插件;真正可用的是 wbond 维护的 Git 插件和 GitSavvy,前者通过命令组合实现准可视化提交流,后者提供完整图形化 Git 工作流,二者互斥且均依赖正确配置的系统 Git 环境与项目根目录打开方式。

GitLog 插件在 Sublime Text 中并不存在官方支持或广泛维护的版本——它不是 wbond 维护的 Git 插件,也不是社区主流认可的 Git 工具(如 GitSavvy),搜索 Package Control 仓库或 GitHub 官方生态均无稳定、持续更新的 GitLog 包。你看到的“GitLog”大概率是混淆了名称,或是某个已废弃、仅适配旧版 Sublime 的小众分支。
真正能实现「可视化提交流程」(含状态面板、文件差异预览、暂存控制、提交信息编辑)的,只有两个可靠选择:Git(wbond 维护)和 GitSavvy。前者轻量直连 CLI,后者提供类 IDE 的交互式 Git 面板。下面直接说怎么做。
为什么搜不到 GitLog 或安装后不生效
Package Control 里没有名为 GitLog 的插件。常见误源包括:
– 某些中文教程把 Git 插件的 Git: Log 命令误写成“GitLog”;
– 有人将 GitGutter(仅显示行级修改标记)或 SideBarGit(右键菜单增强,无状态面板)错认为日志工具;
– 极少数 fork 项目曾用过 GitLog 名字,但 2024 年后全部停止更新,且不兼容 Sublime Text 4.5+。
如果你执行 Ctrl+Shift+P → 输入 Git: Log 却提示“command not found”,说明你装的不是 Git 或 GitSavvy,而是无效包。
用 Git 插件实现准可视化提交(推荐轻量场景)
Git 插件本身不带图形化日志视图,但它通过命令组合 + 内嵌只读面板,达成可点击、可跳转、可暂存的“准可视化”提交流:
-
Git: Status(快捷键Ctrl+Shift+G)打开状态面板:灰色 = 未跟踪/已修改,绿色 = 已暂存;点击文件名可跳转到对应位置 - 光标停在某行文件上,按
s暂存(git add),按u取消暂存,按d查看 diff(工作区 vs 暂存区) -
Git: Commit(Ctrl+Shift+K)弹出新标签页,支持Shift+Enter换行,保存即提交;注意:不自动-a,未add的文件不会进本次提交 - 中文 commit message 显示乱码?运行
git config --global core.quotepath false,并确保 Sublime 文件编码为 UTF-8(File → Reopen with Encoding → UTF-8)
用 GitSavvy 实现完整可视化 Git 工作流(推荐协同/中大型项目)
GitSavvy 是目前 Sublime 生态中唯一提供分层状态面板、分支树、交互式合并、图形化日志(Git: Log)的插件。它不依赖外部 GUI,所有操作都在 Sublime 标签页内完成:
- 安装后必须用
subl .(终端启动)或从 Finder/Explorer 打开整个项目文件夹(含.git/),否则面板空白 -
Ctrl+Shift+P→Git: Toggle Status(或Ctrl+Shift+G)呼出主面板:左侧文件列表支持a/u暂存/撤销,Enter查 diff,c提交 -
Git: Log(Ctrl+Shift+O)打开提交历史:每条记录可Enter展开变更文件,再Enter查某文件 diff,o检出该版本 - 首次推送需先
Git: Push with Options勾选 “set upstream”,否则报fatal: The current branch ... has no upstream branch - 冲突时侧边栏文件变红,双击打开会看到
标记,手动清理后必须Git: Add File再Git: Commit,不能跳步
关键路径和容易被忽略的点
所有可视化效果的前提,是 Sublime 真正“感知到 Git 仓库”。这不是靠打开一个 JS 文件实现的,而是靠目录结构和环境变量双重确认:
- 必须通过
File → Open Folder…(或subl .)打开包含.git/的根目录,子目录或单文件打开 → 插件完全静默 - Windows 用户若用 Git Bash 启动 Sublime,
git命令可能不可见;应改用开始菜单或资源管理器启动,并确认系统 PATH 含C:\Program Files\Git\cmd\git.exe - macOS 用户若用 Homebrew 安装 git(路径通常是
/opt/homebrew/bin/git),必须在Preferences → Package Settings → Git → Settings – User中显式写死:"git_command": "/opt/homebrew/bin/git",否则 GUI 启动时找不到 -
GitSavvy和Git插件互斥:同时启用会导致右键菜单冲突、Git: Commit失效、错误提示被吞掉——装完一个就禁用另一个











