PhpStorm补全失效主因是Ctrl+Space被系统或输入法劫持，需禁用对应热键；三档补全快捷键功能不同：Ctrl+Space为基础补全、Ctrl+Shift+Space为智能补全、Ctrl+Alt+Space为语句补全；PHPDoc缺失导致__get/__call动态成员不补全；Composer新类需标记vendor/autoload.php为Sources Root并重载项目。
补全不触发？检查 Ctrl+Space 是否被系统或输入法劫持
PhpStorm 默认用 Ctrl+Space 触发基础补全，但 Windows/macOS 的系统快捷键、中文输入法（尤其是搜狗、微软拼音）常会拦截这个组合键，导致按了没反应。不是插件坏了，也不是项目没索引好，就是键盘信号根本没传进 IDE。
- Windows 用户：进「设置 → 时间和语言 → 语言 → 中文 → 选项 → 微软拼音 → 选项 → 热键」，禁用「中英文切换」对应的
Ctrl+Space - macOS 用户：进「系统设置 → 键盘 → 快捷键 → 输入源」，关掉「在输入源之间选择」的快捷键
- 验证方式：打开任意编辑器（如记事本），按
Ctrl+Space，如果弹出输入法候选框，说明问题在此
Ctrl+Shift+Space 和 Ctrl+Alt+Space 补全行为差异在哪
PhpStorm 提供三档补全粒度，混淆使用会导致“明明有方法却补不出来”：
-
Ctrl+Space：基础补全（类名、函数名、变量名），依赖当前作用域可见符号 -
Ctrl+Shift+Space：智能补全（SmartType），根据上下文类型推导——比如在$user->后按它，会优先列出User类的方法，跳过无关的全局函数 -
Ctrl+Alt+Space：语句补全（Statement Completion），用于补全整个结构，比如输入foreach后按它，自动生成foreach ($arr as $item) { }框架
常见误操作：在对象调用链里只按 Ctrl+Space，结果补出一堆全局函数；换成 Ctrl+Shift+Space 才真正精准。
PHPDoc 注释缺失时，__get/__call 动态属性和方法不补全
PhpStorm 不会猜魔法方法返回什么。如果你用 __get 暴露动态属性（比如 Laravel 的模型属性），或用 __call 做代理，IDE 默认无法识别这些运行时才存在的成员。
立即学习“PHP免费学习笔记（深入）”；
- 必须写 PHPDoc 显式声明，例如：
/** * @property string $name * @method User setName(string $name) */
- 注释要写在类定义上方，不能写在方法里或单独 PHPDoc 块中
- 写完后按
Ctrl+Shift+O（Optimize Imports）或手动触发索引更新（File → Reload project from disk），否则补全不会立刻生效 - 注意：Laravel 项目建议装
Laravel Idea插件，它能自动解析Model的$fillable、$casts等生成补全提示
Composer 自动加载失效导致新类不补全
刚 composer require 一个包，类名输一半按 Ctrl+Space 却没出来——大概率是 PhpStorm 没读到 vendor/autoload.php 的 PSR-4 映射。
- 确认
vendor/autoload.php已被标记为「Sources Root」：右键该文件 → 「Mark Directory as」→ 「Sources Root」 - 检查
composer.json的autoload或autoload-dev配置是否合法，比如路径拼错、缺少psr-4键 - 执行
composer dump-autoload -o，再在 PhpStorm 中点右上角「Reload project」按钮（不是重启 IDE） - 极端情况：PhpStorm 缓存损坏，可尝试
File → Invalidate Caches and Restart…→ 选「Invalidate and Restart」
补全本质是静态分析 + 符号索引，没有真实加载类，也不运行代码。所以哪怕 class_exists() 返回 true，只要 IDE 没扫到定义位置，就不会出现在补全列表里。
