WebStorm 查看文件修改历史分 Git History 和 Local History 两条路径:Git History 需右键 Project 窗口文件触发,依赖 .git;Local History 是 IDE 快照,适用于未提交或已删文件,快捷键 Alt+Shift+H(Win/Linux)或 Cmd+Shift+H(macOS)。

WebStorm 查看文件的本地修改历史,核心分两条路:走 Git 的叫 Show History(依赖 .git),不走 Git 的叫 Local History(纯 IDE 快照)。别混用,也别指望一个功能解决所有场景。
怎么快速打开当前文件的 Git 提交历史
右键必须点在 Project 工具窗口里的文件上,不是编辑器标签页、也不是代码编辑区——这是 80% 用户卡住的第一步。菜单里出现 Git → Show History 才算路径对了。
- 如果没这个菜单项,先检查项目根目录是否存在
.git,再确认VCS → Git → Remotes能正常配置(否则 WebStorm 不认这是 Git 项目) - 打开的
History窗口默认只显示当前分支,想查跨分支修改,得取消勾选Only Show Selected Branch - 双击任意一条记录,直接进差异视图;按住
Ctrl(macOS 是Cmd)多选两次提交,右键 →Compare Versions可比任意两个版本
文件删了或还没加 Git,怎么找回最近改过的内容
这时候只能靠 Local History——它不读 .git,是 WebStorm 自己每分钟/每次保存时拍的快照,适合救急。
- 快捷键:
Alt+Shift+H(Windows/Linux)或Cmd+Shift+H(macOS),但注意:该快捷键只对「已存在且未被删除」的文件生效 - 如果文件已被删,得先在
Project视图空白处右键 →Local History → Show History,然后从列表里手动定位到那个文件名 -
Settings → System Settings → Local History可调保留天数(默认 5 天)和快照频率,大项目建议调高「Save files automatically when application is idle」避免漏拍
为什么 Ctrl+D 对比不了,或者对比窗口一片空白
Ctrl+D(macOS Cmd+D)触发的是「与 HEAD 比较」,不是「与上一次保存比较」,前提很硬:文件必须已被 Git 跟踪,且至少有一次 commit。
- 新文件没
git add过?对比窗口右侧会显示no content on remote side,不是 bug,是设计如此 - 对比窗口右上角有三个视图模式图标:
Side-by-side、Inline、Unified,默认可能是Side-by-side,想看行内红绿标变更,必须点中Inline - 如果差异块颜色看不见,去
Settings → Editor → Color Scheme → Diff & Merge检查Inserted/Deleted/Modified三类颜色是否被设成透明或与背景同色
想看某一行是谁什么时候改的,别翻整个 History
把光标停在那行代码上,右键 → Git → Annotate(或快捷键 Ctrl+Shift+A 搜 Annotate),立刻在行号旁显示每行最后一次 commit 的作者、时间、哈希前缀。
- 点击行号旁的哈希值,自动跳转到对应提交的
Log标签页,还能继续点进去看完整 diff - 如果某行显示
Working copy,说明这行是本地新增/修改、还没 commit,Annotate不会追溯到更早的提交 - 想查某段选中代码的历史(比如一个函数体),右键 →
Git → Show History for Selection,结果只列和这段代码相关的提交,过滤更准
Local History 和 Git History 不同步、不互通,前者存本地磁盘、后者存 .git,恢复误删文件时别只盯 Git —— 那个文件可能压根没 commit 过。


















