webstorm原生不支持实时git blame浮层，最稳路径是右键行号区选择“annotate with git blame”，它依赖本地仓库、响应快、可跳转对应提交历史；若未跟踪文件需先add to vcs。
WebStorm 本身不带原生 Git Blame 行级注解功能，必须靠右键菜单或插件补全；直接看每行是谁、什么时候改的，最稳路径是 Annotate with git blame，不是“Show History”也不是“GitLens”式插件。
右键行号区执行 Annotate with git blame 才是正解
这个操作会把当前文件每一行左侧标上最后一次修改该行的提交哈希、作者、时间，类似命令行 git blame -L <start>,<end></end></start> 的效果，但图形化更直观。它只依赖本地 Git 仓库，不需要网络、不拉远程历史，响应快。
- 必须右键点击行号区域
- 如果菜单里没出现该选项，说明当前文件未被 Git 跟踪（状态为红色“Unversioned”），先右键 →
Add to VCS再试 - 注解视图里点击任意一行的提交哈希，会自动跳转到对应
Show History窗口，并高亮该次提交 —— 这是查上下文最快的方式 - 退出注解模式只需按
Esc或右键 →Hide Annotations
Show History for Selection 适合窄范围追溯
当你已经选中某几行（比如一个函数体、一段配置值），想确认这几行最近几次是怎么演化的，Show History for Selection 比全局 Show History 更精准。它底层调用的是 git log -L，只过滤出影响所选代码段的提交。
- 选中代码后右键 →
Git→Show History for Selection，窗口里只会列出真正改过这几行的提交 - 注意：如果选中了空行或注释行，可能返回空结果 ——
git log -L只匹配实际变更的源码行 - 该功能对重命名/移动后的文件支持有限；若函数被整体剪切粘贴到新文件，历史会断掉
别指望默认界面显示 Blame，GitToolBox 插件是妥协方案
WebStorm 原生不提供右侧边栏实时 Blame 浮层（像 VS Code + GitLens 那样）。想在编辑时随时瞄一眼某行作者，目前唯一可行的是装 GitToolBox 插件。但它有明显副作用：
- 安装后需重启 WebStorm，且首次加载注解可能卡顿几秒（尤其大文件）
- 它会在编辑器右侧加一列固定宽度的“作者+时间”栏，但默认不显示提交哈希，想看完整信息还得点进去
- 和 WebStorm 自带的
Annotate功能共存时，两个注解源可能冲突，建议禁用其中一个 - 插件更新滞后，某些新版 WebStorm（如 2025.3+）会出现右侧栏错位或文字截断
常见失效场景和绕过方式
遇到 Annotate 显示 “No blame information” 或整行标成灰色，通常不是插件问题，而是 Git 层面的状态异常：
- 文件刚被
git add但还没 commit：Blame 无来源，得先提交一次 - 分支刚从远程 fetch，但本地没 merge/rebase：执行
git merge origin/main或git rebase origin/main后再试 - 文件被
git mv重命名过：默认git blame不追踪重命名，加-C参数才识别，而 WebStorm 的Annotate不支持传参，此时只能切 Terminal 手动跑git blame -C filename - 使用了
worktree：WebStorm 当前项目根目录若不在主 worktree 下，Annotate会找不到 .git，必须确保打开的是主 worktree 根目录
Blame 的本质是找“最后一笔写入该行”的提交，不是找“定义该变量/函数”的提交。如果某行被格式化工具自动缩进、空格增减，Blame 也会跳到那次格式化提交 —— 这点容易误判，动手前先看下 diff 是否真有逻辑变更。
