直接迁移 config 目录最省事，但需确认路径匹配新版默认读取 ~/.config/JetBrains/PhpStorm2025.1/config，旧配置通常在 PhpStorm2024.3 目录下；跨大版本应优先用 Export/Import Settings 导入 editor 配置，并单独处理 vmoptions 文件。
直接迁移 config 目录最省事，但得先确认路径是否匹配
新版 PhpStorm 默认读取 ~/.config/JetBrains/PhpStorm2025.1/config，而你的旧配置很可能还在 ~/.config/JetBrains/PhpStorm2024.3/config 里——IDE 不会自动复制，只新建空目录。所以“配置没了”大概率是路径错位，不是真丢了。
执行前先确认两件事：
- 当前安装版本：phpstorm.sh --version 或看启动页左下角
- 旧配置是否存在：ls -d ~/.config/JetBrains/PhpStorm*
- 若新版目录已存在且为空，关掉 PhpStorm（
pkill -f phpstorm），再用cp -r覆盖整个config目录 - 别漏掉
templates/和options/colors.scheme.xml，它们控制 Live Templates 和编辑器主题 - 如果跨大版本（如 2023.3 → 2025.1），跳过这步，改用导出导入更稳妥
用 Export/Import Settings 导入 editor 配置，避开格式不兼容
直接拷 config 在主版本跳跃时容易触发 UI 崩溃或 keymap 错乱，因为 keymaps/、options/ 下的 XML 结构可能已被 JetBrains 调整。导出导入能过滤掉已弃用项，只保留有效设置。
- 旧版中：打开
File → Manage IDE Settings → Export Settings - 务必勾选：
Editor → Color Scheme、Editor → Code Style、Editor → File Templates、Editor → Live Templates - 务必取消勾选：
Plugins、Keymaps（新版默认适配系统）、System Settings（含密码等敏感项） - 导出路径用纯英文，比如
~/phpstorm-backup/editor-2025.jar，中文或空格会导致部分插件读取失败
vmoptions 文件必须单独处理，它不参与任何导出导入
phpstorm64.vmoptions 控制 JVM 启动参数（堆内存、GC 策略），IDE 启动前就加载了，完全不在 Export Settings 范围内。漏掉它，你会遇到启动卡顿、频繁 GC、java.lang.OutOfMemoryError: Java heap space，甚至激活失效（-javaagent 行丢失）。
- 先定位文件：不同安装方式路径差异大，用
find ~ -name "*vmoptions" 2>/dev/null最快 - 常见位置：
~/PhpStorm-2025.1/bin/phpstorm64.vmoptions（tar.gz）、~/.config/JetBrains/Toolbox/apps/PhpStorm/ch-0/bin/phpstorm64.vmoptions（Toolbox）、C:\Program Files\JetBrains\PhpStorm\bin\phpstorm64.vmoptions（Windows） - 备份时建议加环境标识，比如
phpstorm64.vmoptions-centos-dev，避免混用
导入后编辑器主题/模板不生效？检查这三个地方
导入成功 ≠ 立即可用。编辑器配置依赖多个隐性条件，缺一不可。
立即学习“PHP免费学习笔记（深入）”；
- 重启 PhpStorm：
File → Manage IDE Settings → Restore Settings不会热重载颜色或模板，必须全进程重启 - 第三方主题需预装插件：比如用了 Nord 主题，新环境得先装
Nord Theme插件，否则colors.scheme.xml被静默忽略 - Live Templates 上下文要匹配：PHP 片段得放在
PHPcontext 下，XML 文件里<context><option name="PHP" value="true"/></context>这行不能少，否则模板不触发
最易被忽略的是 options/registry.xml 和 options/other.xml —— 它们存着实验性开关，新版可能已移除或改名，导致部分编辑器行为异常却不报错。跨版本迁移时，这两个文件最好手动比对，别直接覆盖。
