PhpStorm移动PHP文件后命名空间不自动更新，根本原因是未满足PSR-4结构要求：文件须属已标记的Sources Root、composer.json含合法psr-4映射、路径与命名空间严格对应、且原文件namespace声明完整且位于首行。
PhpStorm 移动 PHP 文件后，命名空间不会自动更新 —— 除非你按 PSR-4 规则移动，且文件已在正确标记的源根目录下。
移动 PHP 文件时命名空间不更新的常见原因
很多人以为选中文件 → Refactor → Move → 点确定，IDE 就会像重命名类一样同步改 namespace 和 use 语句。实际不是：PhpStorm 只在满足特定条件时才触发命名空间修正。
- 文件未被识别为「PHP 类文件」（比如扩展名是
.php但内容不含class或namespace声明） - 目标目录未标记为
Sources Root，或未配置 PSR-4 映射（如"App": "src/"） - 移动路径破坏了 PSR-4 层级对应关系（例如把
src/Http/Controller/UserController.php移到src/Controllers/UserController.php，但命名空间仍写AppHttpController） - 原文件里 namespace 声明有语法错误、被注释掉、或位于非首行（比如前面有
declare(strict_types=1);但没换行）
确保命名空间随移动自动更新的操作步骤
这不是“开个开关就能用”的功能，而是一套依赖项目结构和 IDE 配置的联动机制。必须同时满足以下四点：
- 右键点击项目中的
src（或你实际放类的目录），选择Mark Directory as → Sources Root - 确认
composer.json中有合法的 PSR-4 配置，例如：{"autoload": {"psr-4": {"App\": "src/"}}}，然后点击右上角 composer 图标 →Reload project from composer.json - 移动前，确保原文件顶部 namespace 声明完整、无注释、且是文件第一个语句（
<?php后直接跟namespace） - 使用
Refactor → Move（F6），在弹出对话框中指定的目标路径，必须能被 PhpStorm 推导出新 namespace —— 比如移入src/Domain/User，它才会尝试改成AppDomainUser
Move 操作后 use 语句没更新？检查这三处
即使 namespace 更新成功，其他文件里的 use 语句也可能漏改。这不是 Bug，而是 PhpStorm 的保守策略：
立即学习“PHP免费学习笔记（深入）”；
-
include/require语句中的路径（如require 'src/Helper.php';）从不被 Move 重构扫描，必须手动改 - 动态引用不处理：比如
$class = 'AppHttpControllerUserController';这种字符串形式的类名，不会被识别为符号引用 - 如果目标文件夹已存在同名类（哪怕在不同命名空间下），PhpStorm 会放弃自动更新
use，避免歧义；此时需手动检查并修正
替代方案：当 Move 不生效时怎么补救
别硬等重构自动修好一切。更可靠的做法是分两步走：
- 先用
Refactor → Move安全移动文件（它至少会改文件路径、更新相对 require 路径、修正本文件内 namespace） - 再对旧 namespace 执行一次
Refactor → Rename（光标停在旧 namespace 名上，按 Shift+F6），勾选Search in comments and strings，它会批量更新所有use语句和字符串中硬编码的旧路径 - 最后运行
composer dump-autoload，验证自动加载是否正常 —— 这步不能跳，否则就算 IDE 显示正常，运行时也会 Class not found
真正容易被忽略的是：PhpStorm 的命名空间推导完全依赖 composer.json 的 autoload 配置和目录标记状态。没配好这两样，任何 Move 或 Rename 操作都只是“改名”，不是“重构”。
