PhpStorm文件对比开箱即用：右键已保存文件选“Compare with Editor”或Ctrl+D快捷键触发，避免Tools→Compare Files；需确保文件已保存、编码一致，行内差异需手动开启齿轮图标或Ctrl+Shift+Alt+D。
PhpStorm 内置的文件对比器不是“需要配置才能用”的功能，而是开箱即用、但触发路径容易选错的工具——用对入口，3 秒出结果；点错菜单，可能弹空窗口或报 No content to compare。
怎么快速触发两个已打开文件的对比
别去 Tools → Compare Files：这个入口要手动填路径，容易误选未保存临时文件或编码不一致的副本，失败率高。
正确做法是让 PhpStorm 自动把当前上下文带进去：
- 在编辑器标签页上右键任意一个已保存的 PHP 文件 → 选
Compare with Editor（注意不是“Compare with…”后面跟一堆路径） - 或者，在
Project工具窗口里按住Ctrl（macOS 是Cmd），点选两个文件 → 右键 →Compare Files - 快捷键最稳：
Ctrl+D（Windows/Linux）或Cmd+D（macOS），前提是两个文件都已在 Project 视图中被选中（非仅打开）
常见错误现象：No content to compare。90% 是因为其中一个文件没保存（标签带 * 星号），或编码不一致（比如一个显示 UTF-8，另一个是 UTF-8 with BOM）。看编辑器底部状态栏就能确认。
立即学习“PHP免费学习笔记（深入）”；
对比时整行变色但看不出哪几个字符变了
默认只做行级差异（line diff），不开启行内差异（inline diff）。你改了 $user->getName() 里的 getName 为 getFullName，它只会标红整行，而不是高亮 Name → FullName。
必须手动开启：
- 进入 Diff 窗口后，点右上角齿轮图标 → 勾选
Highlight differences inside lines - 或直接按快捷键：
Ctrl+Shift+Alt+D（Windows/Linux）/Cmd+Shift+Option+D（macOS）
注意：这个设置不记忆，每次新开 Diff 窗口都要重开一次。没有全局默认开关，也别指望插件自动帮你开——旧版 GitToolBox 甚至会干扰该功能。
对比文件夹为什么 GUI 点不动、卡死或漏文件
图形界面下右键两个文件夹 → Compare with… 在新版 PhpStorm 中基本不可靠：容易假死、跳过 .git 外的隐藏文件、不递归子目录。
真正稳定的方式是命令行调用 IDE 自带的 Diff 查看器：
- 确保
phpstorm.sh（Linux/macOS）或phpstorm64.exe（Windows）已加入系统 PATH，或知道完整路径（如/opt/JetBrains/Toolbox/apps/PhpStorm/ch-0/bin/phpstorm.sh） - 执行：
phpstorm.sh diff /path/to/folder1 /path/to/folder2
关键限制：diff 子命令只接受绝对路径，相对路径会失败；且不会自动处理符号链接或硬链接，遇到循环引用可能卡住。
Git 场景下比错对象：工作区 vs 暂存区 vs 远程分支
很多人想看「当前改了什么」，却误点了文件右键里的 Compare with…，结果比的是两个本地文件，不是和 Git 历史比。
正确入口取决于你要比什么：
- 看工作区修改 vs 上次 commit：
Commit工具窗口（Alt+0+0）里双击文件，或选中后按Ctrl+D - 比两个 commit 里的同一文件：在
Git Log（Alt+0+9）中Ctrl多选两个提交 → 右键 →Compare with each other - 比当前文件 vs 远程分支（如
origin/main）：在Project视图中右键文件 →Git → Compare with Branch...，然后选目标分支
最容易被忽略的一点：Diff 窗口左栏是“基准版本”（只读），右栏是“当前版本”（可编辑）。点左栏的 → 箭头，只是把变更复制到右栏编辑缓冲区，不会自动写回磁盘——你得手动 Ctrl+S 保存，否则关掉就丢。
