WebStorm GitToolBox 插件显示每行提交信息

gitToolBox

能够显示每一行的提交 commit 信息，类似与 webstorm annotate with Git Blame 功能

无法保存应用密钥怎么办?

可以尝试将密码保存方式改成 In KeePass 方式 (Settings > Appearance & Behavior > System Settings > Passwords

密码保存方式这三个选项的区别

那个设置页面里有三个选项，搞清楚差别才知道该选哪个：

In native Keychain — 用操作系统的凭据管理器。macOS 是钥匙串（Keychain），Windows 是凭据管理器（Credential Manager），Linux 是 libsecret / KWallet。这是默认值也是最安全的，因为凭据由系统加密存储、由系统的登录状态解锁。

In KeePass — 用 IDE 自己维护的一个 KDBX 数据库文件（默认在 ~/.config/JetBrains/<产品>/c.kdbx）。可以给这个数据库设一个主密码，不设的话 IDE 用一个存在同目录的密钥文件自动解锁。这就是绕过系统钥匙串的方案。

Do not save, forget passwords after restart — 不持久化，每次重启 IDE 都要重新输。

正文遇到的「无法保存应用密钥」在 macOS 上通常是钥匙串本身出了问题：钥匙串数据库损坏、或者 IDE 的钥匙串访问授权被拒绝过一次之后不再询问。切到 In KeePass 相当于绕开系统钥匙串，让 IDE 自己管，所以能解决。

如果想修钥匙串而不是绕开，可以打开「钥匙串访问」应用，在登录钥匙串里搜 IntelliJ 或 WebStorm，把相关条目删掉让 IDE 重新创建。macOS 13 之后钥匙串访问的入口挪到了「密码」应用里，但「钥匙串访问」这个 App 仍然存在，用 Spotlight 搜得到。

选 In KeePass 的代价是：凭据不再受系统级保护，那个 KDBX 文件如果没设主密码，等于明文可读（密钥文件就在旁边）。所以在公司电脑或者多人使用的机器上，优先修钥匙串而不是切 KeePass。设了主密码的 KeePass 模式安全性是够的，但每次启动 IDE 都要输一次主密码。

GitToolBox 具体提供了什么

正文说的「显示每一行的 commit 信息」只是它功能里的一小部分，而且这一项 WebStorm 原生就有（右键行号栏 → Annotate with Git Blame）。GitToolBox 真正值得装的是这几个原生没有的能力：

1. 行内 blame（Inline Blame）。光标停在哪一行，行尾就淡色显示这一行的作者、时间和提交信息。和原生 Annotate 的区别是：原生 Annotate 是在左侧开一整栏显示所有行的信息，占宽度且需要手动开关；GitToolBox 是跟着光标走的，只显示当前行，不占版面。

这个功能在 Settings → Other Settings → GitToolBox → Blame 里配置，可以调延迟时间、显示的字段、以及文本长度上限。

2. 状态栏和项目树里的分支状态。在 Project 面板的每个目录后面显示当前分支名和领先/落后远端的提交数（比如 main ↑2 ↓1 表示本地有 2 个未推送、远端有 1 个未拉取）。多仓库的项目里这个信息很有用，一眼看出哪个仓库需要 pull。

3. 自动 fetch。定时在后台跑 git fetch，让上面那个领先/落后的数字保持准确。原生 WebStorm 也有自动 fetch，但 GitToolBox 的间隔可配、且能按仓库开关。

4. 提交信息模板和补全。可以配置提交信息的格式模板，输入时自动补全分支名、issue 号。配合 Conventional Commits 规范用比较顺手。

需要注意的性能开销

GitToolBox 的行内 blame 是通过对当前文件跑 git blame 实现的，大文件上会有明显延迟。几千行的文件切过去会卡一下，这是它最常被抱怨的点。

缓解办法：

• 在 GitToolBox 设置里把 Blame 的 Show inline blame 关掉，只保留状态栏和项目树的分支信息。行内 blame 需要时用原生的 Annotate 手动开。
• 调大 blame 的延迟（Delay 参数），光标移动时不立刻查，停留一段时间才显示。
• 关掉自动 fetch 或把间隔调长（默认好像是几分钟一次），网络慢或者仓库很大时 fetch 本身也会占资源。

另外有个容易忽略的点：GitToolBox 会读 git 的历史，所以在 shallow clone 的仓库里 blame 结果不完整。CI 环境或者用 git clone --depth 1 拉下来的仓库，blame 只能追溯到最浅那一层，之前的行会都显示成同一个提交。需要完整历史的话补一下：

git fetch --unshallow

原生 Git 功能：其实大部分够用

装插件之前值得先确认原生功能满足不满足需求。WebStorm 的 git 集成是同类 IDE 里最完整的：

Annotate with Git Blame — 右键行号栏开启。左侧栏显示每行的作者和时间，鼠标悬停显示完整提交信息，点击可以跳到那次提交的 diff。栏位上右键可以配置显示哪些字段（作者、日期、提交信息、hash）。

Show History for Selection — 选中一段代码，右键 → Git → Show History for Selection，只看这几行的变更历史。排查「这行逻辑是什么时候加的、为什么」比 blame 更直接，因为它会把所有涉及这几行的提交列出来，而 blame 只显示最后一次改动。

Git 面板（Cmd + 9） — 提交历史的可视化，支持按分支、按作者、按路径过滤，也支持搜提交信息。比命令行的 git log 好用得多，尤其是要看分支合并关系的时候。

Local Changes / Changelists — 把未提交的改动分组，可以让一部分改动进这次提交、另一部分留着。相当于图形化的部分暂存。新版本 WebStorm 用 Commit 面板替代了 Changelists，但功能还在。

Shelve — 类似 git stash 但独立于 git，存在 IDE 里。好处是能选择性地 shelve 部分文件、能给一组改动命名、恢复时能挑单个文件恢复。日常临时保存改动我用 Shelve 比 stash 多。

Resolve Conflicts 三方合并界面 — 冲突解决的界面是 WebStorm 最强的功能之一，左中右三栏（本地 / 结果 / 远端），能逐块选择，还有 Magic Resolve 自动处理不冲突的块。比在终端里改 <<<<<<< 标记快很多。

我的实际配置

综合下来，我在 WebStorm 里的 git 相关配置是这样的：

• 不装 GitToolBox。原生 Annotate 加 Show History for Selection 已经覆盖了我的需求，省掉行内 blame 的性能开销。
• 开自动 fetch：Settings → Version Control → Git → 勾 Auto-update if push of the current branch was rejected，以及 Update Method 选 Rebase（避免无意义的 merge commit）。
• 密码保存用 native Keychain，出问题就修钥匙串不切 KeePass。
• git 命令行和 IDE 混用。复杂操作（rebase、cherry-pick、reflog 找回提交）在终端里做，因为命令行的行为更可预测；日常的 diff 查看、冲突解决、历史浏览在 IDE 里做，因为可视化确实快。

最后提一句：无论用哪个工具，git reflog 是最后的保命符。任何时候误操作丢了提交，先跑这个：

git reflog

它记录了 HEAD 的每一次移动，包括被 reset 掉的提交。找到目标的 hash 之后 git checkout <hash> 或 git branch recover <hash> 就能救回来。默认保留 90 天，所以别慌。