导出设置必须手动勾选colors、fileTemplates、liveTemplates、inspectionProfiles，避免勾选cache/system/plugins；路径须纯英文；导入后需重启IDE并预装对应插件。
导出设置不等于备份完整配置，漏选关键项或路径含中文，导入后主题/模板/快捷键大概率失效。
导出时必须手动勾选的配置项
PhpStorm 的 Export Settings 对话框默认勾选大部分项，但 colors、fileTemplates、liveTemplates、inspectionProfiles 这几项常被忽略，而它们恰恰控制着配色方案、文件模板、实时模板和代码检查规则——漏掉任一，换机后就丢功能。
-
colors缺失 → 主题/字体颜色还原失败，IDE 界面变回默认灰白 -
fileTemplates缺失 → 新建 PHP 类/Blade 模板时用的是空模板，不是你自定义的带版权头注释版本 -
inspectionProfiles缺失 → 自定义的 PHPStan/PSALM 规则、禁用的警告项全部丢失 - 务必取消勾选
cache、system、plugins—— 它们是运行时生成的数据，不是设置，导入会冲突甚至卡死启动
路径和文件名不能含中文或空格
导出目标路径若含中文（如 /home/张三/PhpStorm设置.jar）或空格（如 /home/user/My Settings.jar），部分插件（尤其是第三方主题、Live Template 解析器）在读取 colors.scheme.xml 或 templates.xml 时会静默失败，不报错但也不生效。
- 推荐路径格式：
/home/username/phpstorm-backup/2026-05-settings.jar - macOS 用户注意：不要用
~/Library/Caches/...路径导出，那是运行缓存目录，GUI 导出功能不从这里读 - Linux/CentOS 下建议直接写绝对路径，避免 shell 变量未展开导致导出到错误位置
导入后为什么快捷键/主题不生效
导入成功 ≠ 设置立即启用。PhpStorm 不会热重载 UI 层或核心行为配置，必须重启才能让 keymaps、colors、options/registry.xml 生效。
立即学习“PHP免费学习笔记（深入）”；
- 导入后务必执行
File → Exit（或直接关进程），再重新启动 IDE - 如果用了 Nord、One Dark Pro 等第三方主题，导入前必须先在新环境安装对应插件，否则
colors.scheme.xml被跳过 - 快捷键方案若已存在同名 keymap（如都叫
Default），导入会新建Default (1)，需手动进入Settings → Keymap设为默认 - 跨大版本迁移（如从 2023.3 → 2024.3）时，
options/other.xml和options/registry.xml中的实验性开关可能已移除，导致部分设置静默失效
绕过 GUI 直接操作 config 目录更可靠
GUI 导入导出依赖 ZIP 解压逻辑，遇到权限异常、磁盘满或 Java 解压库 bug 时容易失败；直接打包解压 config 目录，路径清晰、无中间环节，适合 CI 部署或批量恢复。
- 先关闭 PhpStorm，再操作 —— 否则
options/下的 XML 文件可能被锁住，备份不全 - Linux/macOS 找 config 路径：
Help → Show Log in Explorer→ 上级目录就是config - 备份命令示例：
tar -czvf phpstorm-config-202605.tgz -C ~/.config/JetBrains/PhpStorm2024.3 . --exclude=consoles --exclude=terminal - 恢复时解压到相同路径，首次启动 PhpStorm 时勾选
Do not import settings，防止向导覆盖你刚粘贴的配置
最易被忽略的点：跨版本迁移时，inspectionProfiles 的 XML 结构可能已变更，旧版 profile 导入新版后，某些检查项会自动降级或禁用，但 IDE 不提示 —— 建议升级前先用 Help → Diagnostic Tools → Debug Log Settings 开启日志，再导入，可捕获 Cannot parse inspectionProfiles/xxx.xml 类错误。
