PhpStorm的Refactor → Move不支持多选文件夹批量移动，仅允许单个文件夹或文件执行，且需满足Sources Root标记、PSR-4结构合规、namespace首行无干扰等条件才能自动更新命名空间；批量整理须拆解为手动建目录→逐个Move→人工核验→Replace in Path补漏。
Refactor → Move 不支持多选文件夹批量移动
PhpStorm 明确禁止同时选中多个文件夹执行 Refactor → Move。右键菜单里该选项会直接置灰，或弹出“Cannot move multiple directories at once”错误提示。这不是操作遗漏，而是 IDE 的底层限制：每个目录移动都需独立推导路径语义、校验命名空间映射（对 PHP 目录）、检查子文件冲突，无法并行安全处理。
单个文件夹重命名 + 自动更新命名空间的硬性条件
想让 Refactor → Move 在重命名文件夹时自动修正 PHP 文件里的 namespace 和 use 语句，必须同时满足以下三点：
- 目标文件夹已标记为
Sources Root（右键 →Mark Directory as → Sources Root） - 原文件夹内所有 PHP 文件首行是
namespace声明，且与当前目录结构严格对应（如src/Http/Controllers对应App\Http\Controllers），中间不能有空行或declare语句干扰 - 移动后的新路径仍符合 PSR-4 规则（例如从
src/Controllers移到src/Domain/Controllers），否则命名空间不会被重写
批量整理多个零散文件夹的可行路径
没有“一键归集”的捷径，但可拆解为可控步骤：
- 先手动创建目标父目录（如
src/Shared），并标记为Sources Root - 对每个待归并的源文件夹，单独执行
Refactor → Move（快捷键F6），目标设为新父目录下的子路径（如src/Shared/Helpers） - 每次移动后立刻检查：PHP 文件首行
namespace是否已更新、同级其他文件中的use语句是否同步变更；若未更新，说明该use指向了同名但不同命名空间的类，IDE 主动跳过了——此时必须人工核对或用Ctrl+Shift+R全局替换字符串 - 硬编码路径（如
require __DIR__.'/../old_dir/file.php'）永远不被 Move 扫描，必须逐个文件用Ctrl+Shift+F搜索补漏
Replace in Path 是补救引用遗漏的唯一手段
当文件夹已手动重命名或拖拽移动后，大量路径引用失效，Replace in Path（Ctrl+Shift+R）是唯一能覆盖全部场景的工具：
立即学习“PHP免费学习笔记（深入）”；
- Scope 必须设为
Project或自定义范围，确认vendor/等目录未被Excluded - 搜索内容填旧路径字符串（如
'app/Models/'），替换为新路径（如'app/Domain/Models/'），勾选Match case和Words only避免误替app/ModelsOld/ - 动态拼接路径（如
$path = $base . '/Models/' . $name;）无法被识别，这类逻辑只能靠人工 grep 或 IDE 的Find Usages定位后逐个改
真正容易被忽略的是：文件夹重命名后，composer.json 里 PSR-4 的 autoload 映射不会自动更新，必须手动修改并运行 composer dump-autoload，否则 Class not found 错误会持续出现。
