WebStorm 查看历史提交和回退版本需区分只读浏览（Show History、Annotate、Compare）与实际修改操作（Reset、Revert、Checkout）；Log 标签页是查看完整 Git 历史最稳入口，大仓库建议用终端 git log；reflog 和 Local History 是独立于 Git History 的补救机制。
WebStorm 查看历史提交和回退版本，核心是分清「看」和「动」：Show History 只读浏览，Reset/Revert/Checkout 才真正改变代码状态。别在 History 窗口里瞎点右键菜单，先确认你到底要查记录，还是真要撤销改动。
怎么快速打开文件或项目的完整 Git 历史
按 Alt+9 打开 Version Control 工具窗口，切到 Log 标签页——这是最稳的入口，比右键单个文件更全、更准。
- 它默认加载所有分支（除非你勾了
Only Show Selected Branch），能看清 merge 线、rebase 轨迹、cherry-pick 来源 - 如果 Log 为空，先检查项目根目录有没有
.git；再看Settings → Version Control → Git → Path to Git executable是否指向可用版本（M1/M2 用户常卡在这） - 子模块内 Log 不显示父仓库提交，这是设计行为，不是 bug
- 大仓库（>50k 提交）下 WebStorm 可能卡顿或漏加载，此时终端跑
git log --oneline --graph --all更可靠
右键 Show History 后，哪些操作会改代码状态
在 Show History 窗口里右键某次提交，选项含义差异极大，选错直接丢数据：
-
Reset Current Branch to Here：硬重置，删掉该提交之后所有 commit，工作区强制覆盖——不可逆，且不生成新 commit -
Checkout Revision：检出为分离头指针，只临时切换代码，不影响当前分支历史——适合查看旧版或基于它建新分支 -
Revert Commit：安全方式，生成一个新 commit 把原改动“反着做”——保留历史线，团队协作首选 -
Compare with Working Tree或Compare Versions：只对比，不改任何东西，放心点
行级追溯和误操作恢复，别只盯 Git History
想查某一行是谁、什么时候加的？右键**行号区** → Annotate with git blame，侧边栏显示最后一次引入该行内容的提交哈希、作者、时间。
- 它不记录“编辑行为”，只认内容变更——缩进调整、空行增删、函数整体移动都不会触发更新
- 合并提交默认不参与 blame，需手动勾选
Enable "Annotate merged commits" - 文件已删或还没
git add？Local History是唯一救星：Alt+Shift+H（Win/Linux）或Cmd+Shift+H（macOS），但只存本地、默认 5 天、重启 IDE 即清空 -
git reflog是终极后悔药，WebStorm 不提供图形入口，得开 Terminal 手动输——它能找回reset --hard或删分支后“消失”的 commit，但仅限本地，且可能被 GC 清理
最容易被忽略的是：Git History 和 Local History 完全独立，前者依赖 .git，后者是 IDE 快照；reflog 又是第三套机制，只存在本地仓库。查不到记录时，先问自己——你找的是哪一层的历史？
