PhpStorm新项目默认路径需在欢迎界面Configure→Project Defaults→Project Structure中设置,该配置写入~/.config/JetBrains/PhpStorm/options/other.xml;迁移时须同步config目录、vmoptions文件及删除system/caches/content.dat.storageData。

项目默认路径在哪改?不是在 Settings 里
PhpStorm 的「新项目默认保存位置」不存于 Settings → Appearance & Behavior → System Settings,而是在欢迎界面的底层配置中。直接改 Settings 只影响当前项目,对新建项目无效。正确路径是:启动后不打开任何项目 → 点击欢迎页右下角 Configure → Project Defaults → Project Structure → 在 Project Content Root 右侧点击文件夹图标选择目标路径 → Apply。这个设置会写入 ~/.config/JetBrains/PhpStorm<version>/options/other.xml</version>,跨重装或迁移时需一并保留。
迁移时 config/keymaps/ 和 config/options/keymap.xml 必须一起动
只复制 keymaps/default.xml 不生效,因为激活状态记录在 options/keymap.xml 里。常见错误现象:导入后快捷键列表里出现 Default (1),但没自动设为默认。迁移时必须打包这两个文件(或整个 config 目录),否则同事拿到配置也用不上。Linux/macOS 下路径通常是 ~/.config/JetBrains/PhpStorm<version>/config</version>;Windows 是 %USERPROFILE%\AppData\Roaming\JetBrains\PhpStorm<version>\config</version>。
system/caches/content.dat.storageData 占 8G+?必须单独迁或删
这个文件属于运行时缓存,不是配置,但默认和 config 同级放在系统盘 system/caches/ 下。重装或迁移时若一并拷过去,大概率触发索引异常、启动卡顿甚至 IDE 崩溃。实操建议:
• 迁移前先关掉 PhpStorm(pkill -f phpstorm)
• 删除旧 system/caches/content.dat.storageData
• 把 config 和 plugins(可选)目录复制过去
• 启动后让 IDE 自动重建缓存,比硬搬快且稳
vmoptions 文件漏掉,IDE 启动就卡死
phpstorm64.vmoptions 不参与任何导出导入,也不在 config 目录里,但它决定 JVM 堆内存、GC 策略等底层行为。漏掉它,现象很典型:java.lang.OutOfMemoryError: Java heap space、启动慢、打开大项目卡死。不同安装方式路径差异大:
• tar.gz 安装:在 ~/PhpStorm-<version>/bin/phpstorm64.vmoptions</version>
• Toolbox 安装:在 ~/.config/JetBrains/Toolbox/apps/PhpStorm/ch-0/bin/phpstorm64.vmoptions
• snap 安装:用户级覆盖路径是 ~/.config/JetBrains/PhpStorm/phpstorm64.vmoptions
建议用 find ~ -name "*vmoptions" 2>/dev/null 快速定位,备份时命名带环境标识,比如 phpstorm64.vmoptions-centos-dev。
立即学习“PHP免费学习笔记(深入)”;
跨版本迁移时,options/other.xml 和 options/registry.xml 最容易静默失效——前者存着默认项目路径,后者含实验性开关,新版可能已移除或改名。别指望全量复制能一劳永逸。


















