必须提前配置好Deployment服务器映射并设为默认，否则右键无“与本地版本比较”选项；需确保映射唯一、Remote Host窗口聚焦、编码与换行符一致，目录对比推荐命令行phpstorm.sh diff。
直接用 PhpStorm 的 Deployment 映射 + 右键对比就能看清本地和服务器文件差异，不需要手动下载、不依赖外部工具——但必须提前配好服务器映射，否则右键菜单里根本不会出现“与本地版本比较”这类选项。
为什么右键没有“与本地版本比较”？
这个菜单项是按需动态生成的，只在满足全部条件时才显示：
- 项目已配置至少一个
Deployment server，且该服务器设置了正确的Local path和Deployment path - 当前选中的远程文件（在
Remote Host工具窗口中）必须有且仅有一个对应的本地文件路径——即映射关系唯一 - 未设置
Default deployment server时，PhpStorm 无法自动决定比哪个本地副本，菜单项会消失；此时需先在Settings → Build, Execution, Deployment → Deployment → Options中勾选Use as default -
Remote Host窗口必须处于焦点状态（不能是 Terminal 或 Git 工具窗口），否则右键无效
对比时整行标红但内容其实一样？检查换行符和 BOM
FTP/SFTP 同步或跨平台协作（Windows 传到 Linux 服务器）极易导致换行符不一致或 BOM 残留，而 PhpStorm 的 Deployment 对比默认不做归一化处理：
- 打开两个文件，分别看编辑器右下角状态栏：确认都显示
UTF-8（不是UTF-8 with BOM），且换行符都是LF（不是CRLF） - 若发现差异仅由空格/制表符/末尾空行引起，在 Diff 窗口右上角齿轮图标中取消勾选
Ignore whitespaces—— 注意这是“忽略显示”，不是“自动修复” - 临时验证：在服务器上用
file -i filename.php查编码，用unix2dos -i或dos2unix -i查换行符类型
想比整个目录但 GUI 卡死？改用命令行 diff
在 Remote Host 窗口里右键文件夹选“与本地同步”，界面容易假死或漏比隐藏文件（如 .env、.gitignore），尤其当目录层级深、文件数多时：
立即学习“PHP免费学习笔记（深入）”；
- 更稳的方式是终端执行：
phpstorm.sh diff /path/to/local/folder /path/to/remote/mounted/folder - 注意：两个路径必须是绝对路径；如果远程目录没挂载到本地，得先用
rsync或scp -r拉一份快照再比 - 命令行方式默认跳过
.git、自动忽略尾部空格，且支持F7/Shift+F7快速跳转差异点
同步前必须确认的三件事
Deployment 同步不是单向覆盖，而是双向决策过程，但很多人点完“同步”就关窗，结果误删他人改动：
- Diff 窗口里每个文件左侧的图标含义要分清：
→表示本地 → 远程（将上传），←表示远程 → 本地（将下载），↕表示双向冲突（需人工介入） - 别点全选 → 同步：服务器上可能有你没权限修改的配置（如
config/database.php被运维单独维护），应逐个勾选确认 - 如果远程文件被其他人修改过，且你本地没拉最新版，同步操作会直接覆盖对方提交——建议先在
Remote Host窗口右键该文件 →Download from here拉下来再比一次
Deployment 对比真正的难点不在怎么点，而在于映射是否干净、编码是否统一、以及同步前有没有真正看清每个箭头方向代表什么。一旦映射错一层路径，或者默认服务器没设对，整个流程就卡在第一步——连菜单都出不来。
