根本原因是PHPStorm未正确索引类文件路径，需标记src/为Sources Root、校验composer.json的PSR-4映射、重载项目索引；必须同时开启“Add unambiguous imports on the fly”和“Optimize imports on file save”。
PHPStorm 找不到命名空间、类名不自动加 use，根本原因几乎都不是设置没开，而是 IDE 没法把类名和物理文件路径对上——它不是猜，是查索引。
为什么类名写了却不自动 import
最常见三类情况：
- 类文件所在目录没被标记为 Source Root（比如
app/或src/右键没选Mark Directory as → Sources Root） -
composer.json里的autoload映射写错，例如"App\": "app/"写成"App\": "src/"，导致AppModelsUser对应不到app/Models/User.php - 刚新建的类还没被索引到：File → Reload project from Disk，或等右下角索引进度条走完
注意：Alt+Enter 不起作用时，先看右下角状态栏是不是显示 PHP；如果是 Text，点它切回 PHP 模式。
必须同时开启的两个关键开关
缺一不可，只开一个等于没开：
立即学习“PHP免费学习笔记（深入）”；
-
Add unambiguous imports on the fly：类名全局唯一（如项目里只有 1 个DateTime）时，补全后立刻加use -
Optimize imports on file save：保存时自动补全缺失的use、删掉未用的、按字母排序——这才是真正兜底的机制
路径：Settings → Editor → General → Auto Import → PHP。别漏掉 Enable auto-import in file scope（用于非命名空间文件，比如 index.php）。
PSR-4 映射失效：src/App/Http/Controller/UserController.php 不识别为 AppHttpControllerUserController
这不是 PHPStorm 的 bug，是它严格按 composer.json 解析：
- 检查
autoload是否包含"psr-4": {"App\": "src/"}这类映射 - 确认
Settings → PHP → Composer中勾选了Synchronize IDE settings with composer.json，并点了Reload小刷新图标 - 如果 vendor 包也要支持自动导入，得把
vendor/下对应包目录也手动标记为Sources Root（右键 → Mark Directory as → Sources Root）
别信“文件夹名和命名空间一样就能自动对上”——PHPStorm 不做这种推测，它只认 composer.json 或你手动标记的 Source Root。
Alt+Enter 导入失败或弹出多个同名类怎么办
光标停在类名上按 Alt+Enter 是最稳的手动补全方式，但要注意：
- 如果弹出多个
User（比如AppModelsUser和IlluminateFoundationAuthUser），务必看清完整命名空间再选，选错会导致运行时报Class not found - 如果类名已写成
AppModelsUser（带反斜杠），PHPStorm 默认不触发use提示，因为它认为你在用 FQCN - 类名拼错（比如
Useer）、大小写不符（uservsUser）也会让索引匹配失败，Alt+Enter直接不响应
真正容易被忽略的是：PHPStorm 的命名空间解析完全依赖索引完整性。一旦你改过 composer.json 或新增了大量类，不手动 reload 或等索引完成，所有自动导入功能都会“假装失明”。
