GitKraken插件仅提供跳转功能，点击即唤起独立桌面应用，不嵌入任何面板或可视化界面；其依赖系统命令gitkraken启动，需确保CLI已正确注册且VSCode已识别当前Git仓库。
GitKraken 插件在 VSCode 里根本不提供面板，也不做任何深度集成——它只是一个跳转按钮，点一下就唤起独立的 GitKraken 桌面应用。
如果你指望在 VSCode 侧边栏看到分支图、提交历史可视化、拖拽变基或图形化 cherry-pick，GitKraken 插件做不到。它连个内嵌窗口都没有。
gitkraken 命令打不开？先查 CLI 是否注册
插件底层靠系统命令 gitkraken 启动桌面端，不是调用 API 或嵌入进程。
常见失败原因全是 CLI 没配好：
- macOS：GitKraken → Preferences → 勾选 Enable command line interface
- Windows：重装时必须勾选 Add GitKraken CLI to system PATH
- Linux：手动软链（路径以实际解压位置为准）
sudo ln -sf /opt/gitkraken/resources/app/gitkraken /usr/local/bin/gitkraken
验证方式很简单：终端里运行gitkraken --version
有输出才说明 CLI 可用；没反应或报 command not found，插件必然失效。
点击插件按钮没反应？大概率不是插件问题
VSCode 的 gitkraken.open 命令是条件激活的，两个硬性前提缺一不可：
git-staged-commit-message
下载
仅从仓库的暂存文件生成 Git 提交消息。当用户要求 Codex 根据暂存更改、缓存差异、Git 索引或已通过 `git add` 添加的文件来编写、起草、创建或建议提交消息时使用；切勿代表用户执行提交操作。
- 当前工作区根目录下存在
.git文件夹（不能是子目录里的） - VSCode 已识别该仓库：左下角状态栏要显示分支名（如
main），否则命令根本不加载
排查步骤：
- 打开终端，进项目根目录，确认
git status能正常执行 - 看 VSCode 左下角有没有分支标识；没有就说明 Git 扩展没认出仓库
- 重启 VSCode，或禁用再启用插件
gitkraken.gitkraken - 新建空文件夹、未
git init的目录，按钮永远灰掉——这是设计使然，不是 bug
想在 VSCode 里看图形化提交历史？别用 GitKraken 插件
它不提供任何视图、不渲染图表、不监听仓库事件。真正在编辑器里画分支图的方案只有两个：
- 安装
Git Graph（扩展 ID：mhutchie.git-graph）：侧边栏实时渲染 commit 图，支持点击跳转、右键变基、拖拽合并 - 用 VSCode 自带的
Git: Show Git Output（Ctrl+Shift+P 输入），看纯文本日志——虽然不图形化，但稳定、无依赖
GitLens 也能增强历史浏览（比如 Commit Graph 视图），但它和 GitKraken 插件完全无关，别混淆。
真正“深度集成高阶 Git 工作流”的路径，其实是：
用 VSCode 内置 SCM 面板做日常暂存/提交/分支切换 + Git Graph 看图 + 集成终端跑 git rebase -i / git cherry-pick ——所有操作都在一个窗口完成。
而 GitKraken 插件唯一价值，就是省掉一次 Alt+Tab 切到 GitKraken 应用的动作。仅此而已。
