右键文件→Git→Show History可查单文件修改轨迹，等价于git log --follow --oneline path/to/file.php；重命名后需用--follow参数补全历史，PhpStorm不自动支持。
右键“Show History”只查单文件，不是项目级日志
想看某个文件的完整修改轨迹，直接在 Project 工具窗口里右键该文件 → Git → Show History。别用 Ctrl+Shift+E（那是项目级日志），那个会混入大量无关提交，根本筛不出这个文件到底在哪次改过。
常见错误是点了整个项目右键 → Show History，结果出来几百条提交，但其中很多压根没动这个文件——因为那是按分支/时间聚合的全局流，不是按文件路径索引的。
- 该操作等价于命令行
git log --follow --oneline path/to/file.php，但 PhpStorm 不自动加--follow - 如果文件被重命名过（比如
user.js→auth.js），右键历史默认只显示改名后的记录；改名前的历史要手动在命令行补查 - 首次打开可能延迟 1–2 秒，PhpStorm 正在解析该文件路径下的所有 commit 引用，不是卡死
双击历史条目打不开对比？检查文件是否还在当前工作区
在文件历史列表里双击某次提交，预期是打开 diff 视图。但如果只看到空白面板或提示 File not found in working tree，说明那次提交里的文件路径和当前工作区不匹配。
典型原因有三个：
立即学习“PHP免费学习笔记（深入）”；
- 该提交中文件已被删除，而你当前工作区没恢复它（
git checkout <commit> -- path/to/file才能临时拉回来） - 文件被移动过，但 PhpStorm 没识别出 rename 关系（比如从
src/old/移到src/new/，且没用 IDE 的 Refactor → Move） - 你正在查看 submodule 或外部仓库里的文件，PhpStorm 默认不跨 repo 关联历史
更稳的办法：右键某次提交 → Show Diff with Working Tree，这个动作强制比对「那次提交快照」和「你现在打开的文件内容」，不依赖路径一致性。
筛选“只改了这个文件”的提交，得靠搜索框语法
单文件历史窗口顶部有搜索框，输 path:src/config/db.php 就能锁定只涉及该路径的提交。注意不是 file: 或 name:，只有 path: 有效。
如果想进一步缩小范围，可以组合使用：
-
path:config/ author:李四—— 查 config 目录下李四的所有修改（空格即隐式 AND） -
path:api/ regex+ 输入POST|GET—— 找 api/ 下提交信息含 HTTP 方法的记录 - 不支持
path:*.js这种通配，必须写具体路径或目录，如path:js/
灰色提交（带虚线边框）表示它不在当前分支可到达路径上，比如来自已删的 feature 分支，这类提交点进去能看到内容，但不能 reset 或 cherry-pick。
重命名后历史断掉？命令行才是唯一可靠解法
PhpStorm 的文件历史对 rename 支持有限。哪怕你用 IDE 的 Refactor → Rename，它也只在后续提交里记录新路径，不会自动把旧路径的历史合并进来。
真正要追溯一个文件从创建到多次重命名的全链路，必须切终端执行：
git log --oneline --follow --all -- path/to/current-name.js
关键点：
-
--follow是核心，没有它 rename 就是断的 -
--all确保不漏掉其他分支上的早期提交 - 输出里的哈希值可复制回 PhpStorm 日志窗口，按
Ctrl+F跳转定位
IDE 做不到的事，就别硬等它支持。日常开发中，只要 rename 操作都走 IDE Refactor，至少能保证新路径历史连续；老路径的归档记录，留一手命令行备用就行。
