PHP语法提示依赖解释器配置、Composer自动加载识别、精确类型声明及索引正常，任一环节缺失或损坏均导致补全失效；需依次检查并修复。
PHP 解释器没配，语法提示一定不工作
PhpStorm 的 PHP 语法提示（比如函数参数提示、类方法自动补全、__construct 参数推导）完全依赖于已配置且可执行的 PHP 解释器。没配解释器，或配了但路径错误、版本太低（如 PHP 5.6），Ctrl+Space 补全和悬停提示基本失效，甚至会报 Cannot resolve PHP language level。
- 进入
File → Settings → Languages & Frameworks → PHP - 检查
Interpreter是否有有效路径；若为空或显示Not configured，点右侧...添加本地 PHP 可执行文件（如/usr/bin/php或C:\php\php.exe） - 确认
Language level与你项目实际使用的 PHP 版本一致（例如 Laravel 10 需设为PHP 8.1或更高） - 如果用 Docker 或 WSL，需配置远程解释器（Remote Interpreter），不能只填宿主机路径
vendor/autoload.php 没被识别，Composer 类库无提示
即使 PHP 解释器配好了，composer require 安装的第三方包（如 monolog/monolog）依然不会自动提示——因为 PhpStorm 默认不扫描 vendor/ 目录下的源码，除非它被标记为“Sources”或成功加载了 Composer autoload 映射。
- 确保项目根目录下存在
composer.json且已运行过composer install（生成vendor/autoload.php） - 右键点击
vendor/文件夹 →Mark Directory as → Excluded（⚠️别选这个！这是常见误操作）→ 正确操作是：先删掉已加的Excluded标记，再右键vendor/→Reload project from composer.json - 若没看到该菜单项，打开
Settings → Languages & Frameworks → PHP → Composer，勾选Enable composer support并指定composer.json路径 - 等待右下角出现
Indexing...完成，之后use Monolog\Logger;才能正常跳转和补全
类型声明写法影响提示精度
PHP 7.4+ 的属性类型、PHP 8.0+ 的联合类型、mixed、static 等，直接影响 PhpStorm 对变量方法的推断能力。写得模糊，提示就弱；写得明确，补全才准。
- 避免：
public $cache;→ PhpStorm 不知道它是Redis还是ArrayCache - 推荐：
public Redis $cache;或/** @var Redis */ public $cache;→ 悬停看类型、$cache->后能列出所有 Redis 方法 - 函数返回值也一样：
function getConfig(): array比function getConfig()更利于后续$config['db']的键名提示（配合 PhpDoc 可进一步增强） - 注意：PHPStan / Psalm 注解（如
@psalm-return list）PhpStorm 不识别，仅支持原生 PHP 类型和基础 PhpDoc（@var,@return）
/** * @param string $key * @return array{host: string, port: int}|null */ function getConnectionConfig(string $key): ?array { // ... }
缓存和索引损坏会导致提示突然消失
改完配置或升级 PhpStorm 后，语法提示“昨天还好，今天全没了”，大概率不是设置问题，而是本地索引损坏。PhpStorm 的代码洞察高度依赖后台索引，一旦异常，补全、跳转、重命名都会失灵，且界面无明显报错。
- 先试最轻量操作：菜单栏
File → Invalidate Caches and Restart → Invalidate and Restart - 不建议勾选
Delete IDE system directories（会清空主题、插件等设置） - 重启后观察是否恢复；若仍无效，可手动删除项目级索引：
rm -rf .idea/index/（macOS/Linux）或进.idea/文件夹删掉index子目录（Windows） - 特别注意：启用
PHP Language Level后首次索引可能耗时数分钟，状态栏显示Updating indices期间补全不可用属正常
PhpStorm 的 PHP 提示不是“开个开关”就完事的，它是一条链：解释器可执行 → Composer autoload 可解析 → 类型信息可推断 → 索引未损坏。任一环节松动，提示就会打折扣。最容易被忽略的是 vendor 目录的识别状态和缓存清理时机——很多“提示没了”的问题，其实 reload composer 或 invalidate cache 就解决了。
