必须运行php artisan ide-helper:models --write生成_ide_helper_models.php并标记为PHP Library，否则Laravel Plugin无法提示模型字段；@var注解需用PHP 8.1+数组形状语法才能触发$_POST键名补全。
PhpStorm 默认的代码补全已经很强，但真正让补全“精准到字段级”的，往往不是默认功能，而是插件与类型注解的配合。光装插件不配类型，补全照样失效；只写注解不装对应插件，框架层的动态方法（比如 Laravel 的门面、Eloquent 的字段）依然不会出现。
装 Laravel Plugin 后仍不提示模型字段？检查 ide-helper 是否生成了 _ide_helper_models.php
很多开发者装完 Laravel Plugin 就以为万事大吉，结果 $user->name 不提示 name 字段。根本原因：Plugin 本身不生成模型元数据，它只是“读取”已有的 PHPDoc 或 stub 文件。
- 必须运行
php artisan ide-helper:models --write生成_ide_helper_models.php - 该文件需在项目根目录下，且 PhpStorm 已将其识别为 “PHP Library”（右键 → Mark as → PHP Library）
- 若用的是 Laravel 11+，注意
ide-helper包是否兼容——部分旧版不支持模型属性的 readonly/nullable 推断 - 生成后重启索引：File → Reload project from Disk，或手动触发
File → Invalidate Caches and Restart…
@var 注解写对了，$_POST['xxx'] 还是不补全？确认用了 PHPStan 风格数组形状语法
普通 @var array $_POST 没用，IDE 只知道是 array，不知道键名。要让 $_POST[' 触发键名补全，必须用结构化类型声明。
- PHP 8.1+ 推荐：
/** @var array{username: string, email: string, remember?: bool} $_POST */ - PHP /** @var array
$_POST */，但此时 Ctrl+Space 只提示 string相关方法，不列具体键名 - 注解必须紧贴变量首次使用前，不能写在函数外再期望作用于所有控制器
- 如果多个文件共用同一组请求结构，建议统一抽到
stubs/_globals.php并标记为 Library，而非重复写注解
补全弹窗里一堆无关项？调低 ML 补全权重或关闭“自动插入”干扰项
机器学习排序（ML Completion）在小项目或冷启动时容易把低频但“别人常选”的项顶到前面，反而遮住你真正需要的 save() 或 findOrFail()。
立即学习“PHP免费学习笔记（深入）”；
- 进 Settings → Editor → General → Code Completion，取消勾选
Sort suggestions based on machine learning - 同时关闭
Autopopup code completion（尤其在写 SQL 字符串或正则时，它会疯狂弹窗打断思路） - 把
Insert selected variant by pressing space, dot, etc.留着，但删掉Accept with space—— 改用 Tab 或 Enter 显式确认，避免误触 - 如遇某类补全（如命名空间）总排太靠后，可在同页设置中点击
Advanced→ 调整各类候选（Classes / Methods / Symbols）的优先级权重
最易被忽略的一点：补全是否生效，和当前文件是否被 PhpStorm 正确识别为 PHP 文件强相关。检查右下角状态栏语言标识是不是 PHP，而不是 Text 或 Plain Text；如果是后者，右键 → Override File Type → 选 PHP，否则所有补全逻辑都绕过。这个状态不会报错，也不会提醒，但补全就是不动。
