PHPStorm自动导入use语句需同时启用“Add unambiguous imports on the fly”和“Optimize imports on the fly”，并确保Composer autoload配置正确、类已被索引、PHP语言级别≥7.0。
PHPStorm 默认不会自动插入 use 语句，但开启对应设置后，它能在你输入类名、按 Enter 或 Tab 补全时，自动添加正确的 use 声明——前提是类在当前项目索引中可解析（即已存在且路径正确）。
怎么打开「自动导入」开关
这个功能由两个关键设置控制，缺一不可：
- 启用「Add unambiguous imports on the fly」：对无歧义的类名（比如项目里只有一个
AppModelsUser），输入完直接补全就自动加use - 启用「Optimize imports on the fly」：在你敲完类名、光标离开当前行或保存文件时，自动清理未使用的
use并补全缺失的
路径：Settings / Preferences → PHP → Namespace → Import Settings，勾选这两项。注意：「Show import popup» 不影响自动导入逻辑，只是决定是否弹窗让你选类，日常建议关掉避免干扰。
为什么写了类名却不自动 use？常见原因
最常遇到的不是设置没开，而是 PHPStorm 没法确定你要用哪个类：
立即学习“PHP免费学习笔记（深入）”；
- 类名有多个匹配（比如
User同时存在于AppModelsUser和AppContractsUser），此时它会停住等你选，不会自动插 - 类文件还没被索引到（刚新建的类、或
vendor里某些未被扫描的包），File → Reload project from Disk或手动Index一下 - 当前文件已有同名类定义（比如
class User {}），PHPStorm 认为这是本地类，不走use流程 - PHP language level 设得太低（
Settings → PHP → Language level小于 7.0），部分命名空间解析行为受限
Alt+Enter 手动触发导入的正确姿势
当自动导入没生效，别删了重打，直接把光标停在未解析的类名上，按 Alt+Enter（macOS 是 Option+Enter）：
- 如果只有一个候选，它会立刻插入
use并替换类名为短名 - 如果有多个，弹出菜单列出所有匹配，用方向键选，回车确认
- 如果想用 FQCN（全限定类名）而不是
use，选「Qualify name」而非「Import class」 - 这个快捷键也适用于函数（如
Str::slug()）、接口、trait，只要它们在索引中
Composer autoload 配置影响自动导入效果
PHPStorm 的命名空间解析依赖 composer.json 中的 autoload 和 autoload-dev 配置。如果你用了 psr-4 但映射路径写错（比如 "App\": "app/" 写成 "App\": "src/"），即使文件物理存在，它也找不到 AppModelsUser 对应的 app/Models/User.php。
验证方式：File → Settings → PHP → Composer 确保「Synchronize IDE settings with composer.json」已勾选，并点击「Reload»；再检查 vendor/composer/autoload_psr4.php 是否生成了预期映射。
自动导入不是魔法，它靠的是准确的项目结构认知。配置不对，再怎么调设置也没用。
