插件配置需精准匹配项目环境：命名空间未注册、依赖未启用或插件冲突会导致补全失效、断点不命中、启动变慢；PHP Annotations需手动添加合法注解命名空间；Laravel Idea依赖完整索引与Blade支持启用；PHP Toolbox依赖原生索引联动；Docker调试须确保路径一致、端口开放及xdebug.client_host正确配置；多索引引擎并存才是性能瓶颈。
装插件不是打开 Marketplace 搜名字点安装就完事——多数人卡在命名空间没注册、依赖没启用、或和已有插件冲突，结果补全失效、断点不命、IDE 启动变慢。
PHP Annotations 注解补全总不弹出 @Route 或 @ORM\Column
它不靠自动扫描，得你手动告诉 PhpStorm 哪些注解类是合法的。否则 @ 后面光标停住，啥也不提示。
- 进
Settings > Languages & Frameworks > PHP > Annotations，点+添加命名空间，比如Doctrine\ORM\Mapping、Symfony\Component\Validator\Constraints - 如果
composer.json里没 requiresymfony/validator，@Assert\NotBlank就不会出现在补全列表里——插件只索引已加载的类 -
@var User $user拼写高亮归它管，但User类是否存在，得靠 PHP Intelephense 或内置引擎校验
Laravel Idea 的 Blade 补全和 Eloquent 提示不生效
它不是语法糖插件，而是靠解析 routes/web.php、模型关系、服务容器绑定来推导上下文。没索引完，$user->name 就是问号。
- 装完首次打开项目会触发后台索引，右下角显示
Laravel Idea indexing时别急着写代码 - 必须确认
Blade files support已启用——它在 Plugins 列表里是独立条目，有时不会随 Laravel Idea 自动勾选 - 绝对禁用旧版
Laravel Plugin：两者对@Route解析逻辑冲突，会导致Route::get跳转直接失效
PHP Toolbox 报“undefined method posts()”却实际能运行
这是框架约定方法（如 Eloquent 关联、Doctrine 实体字段）没被 IDE 识别为合法调用，不是 PHP 运行时报错，而是符号索引缺失。
立即学习“PHP免费学习笔记（深入）”；
- 装完重启即可生效，无需额外配置，但它只对已安装对应框架（如
laravel/framework）的项目起作用 - 如果你禁用了 PhpStorm 原生索引（比如换了 PHP Intelephense），它可能无法联动——此时建议保留原生索引做辅助
- 它不改 PHP 运行时行为，只增强 IDE 的类型提示能力，
$user->posts标黄变蓝，foreach里$post->title才有补全
Docker 插件 volume 映射总失败，远程调试断点不命中
路径映射失败往往不是插件问题，而是本地与容器内路径未严格一致，或防火墙拦了 Xdebug 端口。
- 检查
docker-compose.yml中volumes的路径是否和 PhpStorm 的Settings > PHP > Servers里配置的路径完全匹配（注意绝对路径、斜杠方向、大小写） - Ubuntu 上若用
ufw，需确保开放9003端口：sudo ufw allow 9003 -
xdebug.client_host必须设为你本机在 Docker 网络中的 IP（常为host.docker.internal或网关地址），不是127.0.0.1
真正拖慢 PhpStorm 的从来不是插件数量，而是多个索引引擎（如 PHP Toolbox + PHP Intelephense + 原生引擎）同时活跃。一个项目里，注解、Blade、Eloquent、Docker 四类问题各有一个主力插件覆盖，其余功能尽量交给 PhpStorm 原生支持——这比堆十个插件更稳。
