PhpStorm 不支持批量移动多个 PHP 文件并自动修正命名空间或引用，仅允许单文件或整个目录的 Move 重构，且需严格符合 PSR-4 结构、declare 与 namespace 间无空行才能触发自动更新。
不能直接批量移动多个文件并自动修正命名空间或引用——PhpStorm 的 Move 重构只支持单文件或整个目录，且仅在严格满足 PSR-4 结构时才更新 namespace。
为什么选中多个 PHP 文件 → Refactor → Move 会失败或静默忽略
PhpStorm 不允许对多个 PHP 类文件同时执行 Move 重构。当你在 Project 视图中 Ctrl+多选几个 .php 文件后右键 → Refactor → Move，IDE 会直接禁用该菜单项，或弹出错误提示“Cannot move multiple files at once”。这不是 UI 缺失，而是设计限制：Move 重构需逐个推导目标命名空间、校验源文件合法性、检查冲突，并同步更新 use 语句——这些动作无法安全并行处理。
- 仅支持单文件（
UserController.php）或整个目录（src/Http/Controllers）作为移动单元 - 若强行用系统级拖拽移动多个文件，
namespace和use语句完全不会变，极易导致 Class not found - JavaScript/TypeScript 文件虽支持多选 Move，但 PHP 不在此列
真正可行的“零散文件归集”操作路径
必须拆解为两步：先手动创建目标目录并标记为 Sources Root，再逐个 Move 并验证。这是唯一能触发自动 namespace 修正的方式。
- 右键点击项目根目录（如
src）→ Mark Directory as → Sources Root（若尚未标记） - 在
src下新建目标目录，例如src/Domain/User；确保该路径与你期望的命名空间严格对应（即AppDomainUser） - 对每个待归集的文件，单独右键 → Refactor → Move (F6)，目标路径选
src/Domain/User - 每次 Move 后立即检查：
namespace是否已更新为AppDomainUser，且原文件首行无空行或declare语句干扰
Move 后 use 语句没更新？不是 Bug，是策略性跳过
即使单个文件 Move 成功，其他文件里的 use 语句也可能未被修改——这不代表功能失效，而是 PhpStorm 的保守判断逻辑在起作用。
立即学习“PHP免费学习笔记（深入）”；
- 如果某文件中存在同名类（哪怕在不同命名空间下），例如已有
AppHttpControllerUserController，则 MoveAppDomainUserUserController时，IDE 会放弃自动更新所有use AppHttpControllerUserController，避免歧义 -
require 'app/Helper.php'这类硬编码路径从不被 Move 扫描，必须人工检查 - 字符串中的类名（如
$class = 'AppHttpControllerUserController'）也不会被识别，需用Ctrl+Shift+R全局搜索替换
替代方案：用 Replace in Path 补救 + 手动验证
当 Move 后发现大量 use 漏改，别反复重试 Move，直接上精准文本替换。
- 按
Ctrl+Shift+R打开 Replace in Path -
Text to find填use App\Http\Controller\，Replace with填use App\Domain\User\，勾选Regex和Match case - 设置
File mask为*.php，Scope限定为src目录 - 务必先点
Find预览所有匹配项，确认无误再Replace All - 完成后运行
composer dump-autoload并检查 PHPStan 报错，验证是否真改全了
最易被忽略的是 declare(strict_types=1); 与 namespace 之间不能有空行——只要隔了一行，Move 就不会碰 namespace。这个细节比路径配置还常导致失败。
