调试配置不跨版本自动继承，仅永久配置（不透明图标、存于.idea/runConfigurations/）可导出复用；临时配置（半透明图标）每次运行即丢，无法迁移。
调试配置本身不跨版本自动继承，迁移时必须区分「永久配置」和「临时配置」——只有永久配置能被导出/复制，临时配置每次运行即丢。
确认哪些调试配置属于永久配置
PhpStorm 中的调试配置分两类：带不透明图标的才是永久配置；半透明图标的是临时配置，关掉 IDE 就消失。你在 Run → Edit Configurations… 里看到的、且左侧列表中名称前有实心圆点的，就是可迁移的永久配置。
- 常见永久调试配置类型：
PHP Script、PHP Web Page、PHPUnit、Behat、PHP Remote Debug - 临时配置典型场景：右键某个
.php文件选Run 'xxx.php'，或点击编辑器右上角绿色三角形直接运行 - 永久配置一旦保存，会写入项目根目录下的
.idea/runConfigurations/子目录（XML 文件），随 Git 提交即可复用
跨机器或重装后恢复调试配置
如果目标环境是同一版本 PhpStorm（如都是 2025.1），最直接的方式是复制整个 .idea 目录；但要注意：其中部分路径是绝对的（比如 PHP interpreter path），迁移到新机器后需手动修正。
- 先关闭 PhpStorm，避免文件锁导致复制失败
- 复制源项目下的
.idea/runConfigurations/到目标项目的同位置 - 打开目标项目，在
Run → Edit Configurations…中检查每个配置的PHP script path和Interpreter options是否仍有效 - 特别注意
PHP Web Page类型配置里的URL和Browser设置，可能因本地服务器路径或端口不同而失效
升级 PhpStorm 后调试配置“丢失”的真实原因
不是配置真丢了，而是新版 IDE 默认不读旧版 .idea 目录（尤其大版本跳跃时），或你误删了它。另外，PHP Remote Debug 配置依赖 Xdebug 的端口和 IDE Key，若新版默认监听端口从 9000 改为 9003，旧配置里的 Debug port 值没同步更新，就会连不上。
立即学习“PHP免费学习笔记（深入）”；
- 检查
Preferences → Languages & Frameworks → PHP → Debug中的Xdebug端口是否与你的php.ini里xdebug.client_port一致 - 若用
PHP Remote Debug，确保IDE key字段值和浏览器插件（如 Xdebug Helper）里设置的完全相同（区分大小写） - 升级后首次启动，IDE 可能自动生成一套空的
.idea，此时要先删掉它再粘贴旧配置，否则会被忽略
用 Settings Repository 同步调试配置（适合多设备长期使用）
这是唯一能自动同步调试配置的方式，但需提前启用——它不会回溯已存在的配置，只同步启用后新建或修改的项。
- 安装
Settings Repository插件，并配置一个私有 Git 仓库（GitHub/GitLab 均可） - 首次提交前，确保
.idea/runConfigurations/已存在且非空，否则该目录不会被纳入同步范围 - 在另一台设备上拉取设置后，重启 IDE 才会加载新调试配置；若没生效，检查
Settings Repository设置页是否勾选了Store run configurations
真正容易被忽略的是：调试配置中的路径类字段（如脚本路径、工作目录、PHP 解释器路径）几乎全是绝对路径，复制过去后十有八九要手动改一遍；别指望“一键迁移”能绕过这步。
