离线安装插件必须严格匹配 PhpStorm 主版本、插件自身版本与 JetBrains Runtime（如 JBR 21），从 Marketplace 下载 ZIP 包，通过 Settings → Plugins → ⚙️ → Install Plugin from Disk… 安装后手动启用并重启 IDE；命令行需在 bin/ 目录下执行 ./phpstorm.sh installPlugins /path/to/plugin.zip，安装后须人工核验版本、依赖及功能菜单是否生效。
离线安装插件在内网环境、CI/CD 构建机或网络受限的开发机上是刚需，不是“备选方案”——它直接决定你能不能用上 WordPress、.env files support 或自研框架补全插件。
怎么找对版本的插件 ZIP 包
插件不兼容会直接导致 PhpStorm 启动失败或功能缺失，这不是报错后能轻易回退的问题。关键点在于三重匹配：
-
PhpStorm主版本号（如 2026.2）必须与插件编译时的目标 IDE 版本一致，查看插件页面的 “Compatible with” 字段，别只看大版本（比如 2026.x） - 插件自身版本需支持你的
JetBrains Runtime（当前为 JBR 21），旧插件若声明只支持 JBR 11 就不能装 - 从 JetBrains Marketplace 页面下载 ZIP 是最稳妥的；GitHub Release 页的构建产物需确认是否为官方签名包，第三方打包的
.jar文件可能被 IDE 拒绝加载
从磁盘安装插件的实际步骤
界面操作看似简单，但几个按钮位置和时机容易误操作：
- 进入
Settings/Preferences → Plugins后，**不要点右上角搜索框**，先点右上角齿轮图标（⚙️），再选Install Plugin from Disk… - 选中 ZIP 文件后，IDE 不会立即提示“安装成功”，而是静默返回插件列表 —— 此时要手动勾选新出现的插件名右侧的
Enabled复选框 - 点击
OK后，必须重启 PhpStorm 才生效；仅“Reload plugin”或“Apply”无效，且重启前看不到任何启用状态变化
命令行离线安装（适合批量部署）
在服务器或 Docker 构建阶段，图形界面不可用，必须用命令行。路径和参数容错率极低：
立即学习“PHP免费学习笔记（深入）”；
- 先退出所有
phpstorm.sh进程，否则命令会挂起或报port already in use - 进入
PhpStorm-*/bin/目录执行，例如：./phpstorm.sh installPlugins /path/to/wordpress-plugin-2026.2.zip - 不能用通配符或相对路径；ZIP 文件必须可读，且不能是解压后的文件夹 —— 即使名字带
.zip，内容是目录结构也会安装失败 - 安装后不会自动重启 IDE，需手动触发
./phpstorm.sh启动，首次加载会校验插件签名并初始化索引
装完就以为结束了？这些状态得手动确认
离线安装没有后台更新机制，也没有依赖自动拉取，以下三项必须人工核验：
- 打开
Help → About，检查插件列表里对应插件的版本号是否与 ZIP 包名一致（如wordpress-2026.2.1） - 在
Plugins → Installed页，找到该插件，点开Additional Info标签页，确认Dependencies列表里的插件（如PHP、JavaScript）都已启用且版本满足要求 - 如果插件提供新菜单项（如 WordPress 插件的
Tools → WordPress → Scan Theme），启动一个真实项目后尝试点击，空菜单或灰色不可点说明资源路径未识别，需额外配置项目结构
