Alt+Enter 是补全 use 语句最可靠、最可控的快捷键，它基于符号解析触发“Import class”意图，不依赖补全弹窗，支持同名类选择、trait/interface 中路径确认，并需确保 PSR-4 映射、Sources Root 和索引正确。
Alt+Enter 是补全 use 语句最可靠、最可控的快捷键，不是 Ctrl+Space，也不是 Tab。 它不依赖补全弹窗是否出现，也不受输入法或语言级别限制，只要光标停在未导入的类名上，就能触发“Import class”意图。
为什么 Alt+Enter 比自动补全更值得依赖
自动补全（Ctrl+Space）只负责“列出候选”，而 Alt+Enter 是“执行修复”。很多场景下补全根本不出现在类名后（比如粘贴代码、重构后残留类名），但 Alt+Enter 依然有效——因为它基于符号解析，而非输入上下文。
- 类名已写好但顶部缺
use，直接把光标放上去按Alt+Enter，选Import class - 多个同名类存在时（如
User来自AppModelsUser和IlluminateFoundationAuthUser），Alt+Enter会弹出明确列表，避免误导 - 在
trait或interface中引用外部类，Alt+Enter同样可用，虽然不会自动加到文件顶部（PHP 语法不允许），但它能帮你确认类路径是否可解析 - 如果没反应，先看右下角状态栏是不是显示
Text—— 点它切回PHP模式再试
Alt+Enter 不生效的三个真实原因
不是快捷键坏了，而是 PhpStorm 根本没把类名和文件对上。常见卡点：
-
composer.json里的 PSR-4 映射写错，比如"App\": "app/"写成"App\": "src/"，导致AppModelsUser找不到app/Models/User.php - 类文件所在目录（如
src/）没被右键标记为Sources Root，IDE 不扫描该路径 - 刚新建或重命名类，索引还没完成：执行
File → Reload project from Disk，或等右下角进度条走完
怎么让 Alt+Enter 直接插入，跳过弹窗
默认行为是弹出意图菜单，想省一步直接导入，得调意图设置：
立即学习“PHP免费学习笔记（深入）”；
- 进
Settings → Editor → Intentions → PHP - 确保勾选了
Add PHP use statement - 可选：取消勾选
Show intention actions and quick-fixes，这样Alt+Enter就直接执行首个意图（即 import） - 注意：关掉弹窗后，其他意图（如 “Create method”、“Add @param”）也会消失，日常建议保留弹窗，熟练后按
Alt+Enter+Enter两键搞定
Ctrl+Alt+O 是清理 use 的关键补位操作
Alt+Enter 解决“缺”，Ctrl+Alt+O 解决“多”和“乱”。它不自动运行，但必须手动掌握：
- Windows/Linux：
Ctrl+Alt+O；macOS：Cmd+Alt+O - 效果：删除未使用的
use、合并重复项、按字母排序、把use function和use const单独分组 - 如果团队有特殊顺序要求（比如先
usevendor 类再use自定义类），需关掉Sort imports：进Settings → Editor → Code Style → PHP → Imports - 这个操作不会影响运行时，但能快速暴露“看似导入实则未用”的冗余引用
真正卡住人的从来不是快捷键记不住，而是类名写了却找不到——根源永远在 PSR-4 映射、Sources Root 和索引状态这三处。Alt+Enter 只是把已知路径转成 use 语句的扳手，扳不动的时候，别调快捷键，先去看 composer.json 和右键菜单。
