恢复 PhpStorm 设置需分场景:同版本迁移删空 config 目录后覆盖备份最快最稳;跨版本升级须用 .jar 导入并仅勾选 colors、fileTemplates、liveTemplates、inspectionProfiles 四项,禁选 cache/system/plugins。

恢复 PhpStorm 个性化设置不是“一键还原”能解决的事,关键看你是丢了什么、怎么丢的、当前环境是否干净——直接删 config 目录再覆盖备份,比 GUI 导入更稳;但跨大版本时,.jar 导入反而更安全,前提是手动勾选对的项。
删空新目录 + 覆盖旧 config 最快最稳(同版本迁移)
适用于重装、升级后配置“消失”,且新旧 PhpStorm 版本号完全一致(如都是 PhpStorm2025.1)。
- 先关死所有 PhpStorm 进程:
pkill -f phpstorm(只关窗口不够,后台常驻) - 确认当前版本路径:
ls -d ~/.config/JetBrains/PhpStorm*,找到类似~/.config/JetBrains/PhpStorm2025.1的目录 - 若该目录已存在但为空,直接删掉:
rm -rf ~/.config/JetBrains/PhpStorm2025.1 - 把你的完整旧 config 目录解压或复制过去:
tar -xzvf ~/backup/phpstorm_2025.1.tar.gz -C ~/.config/JetBrains/ - 插件不会自动启用,重启后进
Settings → Plugins点右上角刷新图标,或再重启一次
注意:路径含中文或空格(如 /home/张三/)会导致解压失败或权限错乱;不要把 tar 包解到 ~ 再挪动子目录。
用 .jar 导入只适合跨版本,漏选这四项等于白备份
从 PhpStorm2024.3 升到 PhpStorm2025.1 时,直接复制 config 可能引发 UI 崩溃或 keymap 错乱。.jar 是 JetBrains 官方推荐的跨版本迁移方式,但默认勾选项全是坑。
立即学习“PHP免费学习笔记(深入)”;
- 导出时必须手动勾选:
colors、fileTemplates、liveTemplates、inspectionProfiles—— 漏一个,主题、新建文件模板、自定义代码片段(如dd、log)、PHPStan 规则就全回退到灰白默认 - 必须取消勾选:
cache、system、plugins—— 它们是运行时生成的数据,导入会冲突甚至导致启动卡死 - 导入操作不在 Settings 里做,而是在欢迎界面点
Import settings from .jar file;进 Settings 里导入,部分初始化逻辑会被跳过 - 导入后必须重启,且第三方主题(如
Nord)要提前安装插件,否则colors.scheme.xml静默失效
误删运行配置(Run Configuration)别翻设置,查 Local History
运行配置(如 PHP Script、PHPUnit)实际存为 XML 文件在项目 .idea/runConfigurations/ 下。删了就没了?不是。IDE 每天自动保存本地快照,默认保留 5 天。
- 在项目根目录右键 →
Local History → Show History - 左侧时间线找带
Deleted标记的条目,或滚动到删除前一刻 - 右侧展开
.idea/runConfigurations/xxx.xml,双击预览确认内容(看<option name="SCRIPT_PATH" value="" />等字段) - 右键该文件 →
Revert,文件即恢复;注意:它会覆盖同名现有配置,建议先手动备份.idea/runConfigurations/
如果项目用了 Git 且提交过 .idea/,也可以从 Git 历史找回 —— 但默认 .idea/ 被忽略,别指望它一定在仓库里。
vmoptions 改崩了?删文件就行,别碰安装目录
phpstorm64.vmoptions 改错会导致启动卡死、闪退或报 Invalid JVM options。它不“降级”读安装目录默认值,只要用户目录下这个文件存在,就强制加载。
- 关掉 PhpStorm 后,去用户配置目录删它:
Linux/macOS:~/.cache/JetBrains/PhpStorm202X.X/phpstorm64.vmoptions
Windows:C:\Users\{用户名}\AppData\Roaming\JetBrains\PhpStorm202X.X\phpstorm64.vmoptions - 别去动安装目录
bin/下的phpstorm.vmoptions—— 它是只读模板,改了 macOS 上还会破坏签名 - 删之前可重命名为
phpstorm64.vmoptions.broken备份对比 - 如果还是启动失败,检查环境变量:
echo $PHPSTORM_VM_OPTIONS(Linux/macOS)或echo %PHPSTORM_VM_OPTIONS%(Windows),非空就unset或set清空再试
想看原始默认参数?关掉所有实例,Welcome 屏幕 → 右下角 Configure → Edit Custom VM Options,弹窗标题会写明 “Default VM options” —— 那就是你要的基准值。


















