PhpStorm 的 Ctrl+Shift+Space 补全不优先显示自定义类方法，根本原因是变量类型未被准确识别，导致 IDE 退化为泛列符号；需确保 @var 注解位置正确、PHP 版本匹配、框架插件启用并配置妥当。
为什么 Ctrl+Shift+Space 补全不优先显示你写的类方法
不是 PhpStorm 忘了你的代码，而是它默认按“符号出现频率”或“字母顺序”排序，而非“当前上下文最相关”。Ctrl+Shift+Space（SmartType）本该优先推导类型并过滤出匹配方法，但若变量类型未被准确识别，IDE 就会退化成泛泛列符号——你自己的 save()、toArray() 可能排在第 20 行以后，甚至被第三方库的同名方法盖住。
- 根本原因：变量缺少可推断的类型信息。比如
$user = findUser();中，findUser()返回值没声明，IDE 不知道$user是User类实例 - PHP Language Level 设置过低（如设为 PHP 7.2），会导致构造函数属性提升（
public function __construct(private string $name)）无法被解析，进而影响后续所有调用链的类型推导 - 项目未标记
vendor/为 Sources，或composer.json的 PSR-4 映射未被正确读取，导致自定义类虽存在，却不在补全索引中
@var 注解必须写对位置和格式才能生效
注释写错一行，补全就失效。IDE 只认紧贴变量声明前、且语法规范的 @var。
- ✅ 正确：
/** @var \App\Models\Post $post */<br>$post = Post::find(1);
- ❌ 无效（位置错）：
$post = Post::find(1);<br>/** @var \App\Models\Post $post */
—— 注释在赋值后，IDE 不关联 - ❌ 无效（路径错）：
/** @var Post $post */—— 没带命名空间，除非已use且当前文件无同名类，否则无法唯一确定 - 补全不会实时响应修改：加完
@var后需手动触发Ctrl+Shift+O（Optimize Imports）或右键项目 →Reload project from disk，否则索引不更新
关闭干扰项才能让自定义方法“浮上来”
默认开启的几个补全源，会让 SmartType 变得“太聪明”，反而淹没你真正要的。
- 禁用
Show suggestions regardless of context：它会让全局函数（如array_merge()）混进$obj->后的列表，直接关掉 - 禁用
Statistical code completion：基于历史输入频率排序，新项目几乎没数据，还拖慢弹出速度 - 确保
Include non-imported classes已勾选：否则即使写了new \App\Services\Notifier()，补全也可能漏掉这个类名 - 检查
Case sensitive completion是否启用：关掉它会导致$post->getTitle()和非法的$post->gettitle()一起出现，稀释有效选项
Laravel/Symfony 项目别只靠 @var
框架大量使用魔术方法（__get、__call）、动态属性（$model->name）和运行时绑定，纯 PHPDoc 很难覆盖全。
立即学习“PHP免费学习笔记（深入）”；
- 必须安装对应插件：Laravel 项目装
Laravel Idea，Symfony 装Symfony Support，它们能解析$casts、$fillable、服务容器绑定等元信息 - 插件启用后，仍需确认其设置页是否勾选了 “Enable Eloquent completion” 或 “Auto-detect model properties”
- 如果用了自定义 Repository 或 Service 层，建议在接口上加完整 PHPDoc，并让实现类
implements它——IDE 对接口方法的识别比对魔术方法稳定得多
真正卡住补全排序的，从来不是快捷键按错了，而是 IDE 不知道那个 $obj 到底是什么。类型信息一断，SmartType 就退化成字符匹配——这时候再调排序权重也没用。盯紧 @var 位置、解释器版本、框架插件状态这三点，比反复调 Autopopup delay 实在得多。
