PhpStorm新建PHP类不生成namespace的根本原因是目录未标记为Sources Root、PSR-4映射错误或索引未更新；需右键目录→Mark Directory as→Sources Root，配置composer.json autoload路径与磁盘结构严格一致，并执行Reload project from Disk。
PhpStorm 不会“自动引入命名空间”——它只会在你标记对了目录、配对了 PSR-4 映射的前提下，**新建类时自动生成正确的命名空间声明**。所谓“自动引入”，本质是 IDE 根据目录结构 + 命名空间前缀映射，推导出 namespace 行内容；而 use 语句的补全，则依赖索引是否完整和两个关键开关是否同时开启。
为什么新建 PHP 类没生成 namespace？
根本原因不是设置没点开，而是 PhpStorm 没法把“这个文件放在哪”和“它该属于哪个命名空间”联系起来。
- 项目根目录或
src/、app/等实际存放类的目录，**没被标记为 Sources Root**（右键目录 → Mark Directory as → Sources Root） -
composer.json里"autoload"部分缺失或写错，例如："App\": "app/"写成"App\": "src/"，导致AppModelsUser找不到app/Models/User.php - 刚新建的目录还没触发索引，或索引卡住：菜单栏
File → Reload project from Disk，或等右下角进度条走完 - 当前文件类型被识别为
Text而非PHP：点右下角状态栏切换回PHP模式
怎么让新建类自动带 namespace AppHttpControllers？
必须手动配置目录与命名空间前缀的绑定关系，不能靠猜。
- 进
Settings → Directories（Windows 是Ctrl+Alt+S） - 在中央窗格选中你的源码目录（如
app），点击右侧Sources按钮 - 再点该目录旁的铅笔图标，在
Namespace prefix输入框填App（注意结尾反斜杠） - 勾上
For generated sources，确保新建类时生效 - 此时在
app/Http/Controllers下新建类，IDE 就会自动写出namespace AppHttpControllers;
为什么类名写了却不自动加 use？
这是最常被误解的一环：补全 use 和生成 namespace 是两套机制，且都依赖底层索引准确。
立即学习“PHP免费学习笔记（深入）”；
- 必须同时开启两个开关，缺一不可：
→Add unambiguous imports on the fly（全局唯一类名输完立刻加use）
→Optimize imports on file save（保存时补全、删冗余、排序） - 路径在：
Settings → Editor → General → Auto Import → PHP - 别漏掉
Enable auto-import in file scope—— 它管的是非命名空间文件（如index.php）里的类引用 - 如果用了
vendor包里的类却没提示，要把对应包目录也右键标记为Sources Root
PSR-4 映射改了但不生效？
Composer 配置和 IDE 设置不是单向同步，得双向确认。
- 检查
Settings → PHP → Composer是否勾选了Synchronize IDE settings with composer.json - 点旁边的刷新图标
Reload，强制重读composer.json并更新目录标记 - 运行
composer dump-autoload，确保 PHP 运行时也能加载，否则 IDE 补全对了，执行时仍报Class not found - 改完
composer.json后，IDE 不会自动 reload 索引 —— 必须手动File → Reload project from Disk
真正卡住人的地方从来不是“怎么点设置”，而是目录标记、composer 映射、IDE 索引三者之间有一处没对齐。尤其新拉的项目或重构过目录结构的，先看右下角有没有索引进度，再查 composer.json 里写的路径和磁盘上真实路径是否一致——差一个字母，AppModelsUser 就永远找不到 User.php。
