PhpStorm 不支持批量重命名多个目录和文件并自动更新所有引用；Refactor → Rename 多选仅执行操作系统级重命名，不更新 require、use、类名或 composer.json 映射，必须单文件逐个使用 Shift+F6 才能触发语义化重构。
PhpStorm 里没有“批量重命名多个目录+文件并自动更新所有引用”的一键功能——你试图用 Refactor → Rename 多选操作来统一改名，结果发现路径没更新、类名没变、use 语句还报错，这不是你操作错了，是 PhpStorm 根本不支持这种跨语义层的批量动作。
Refactor → Rename 多选只改名，不更新任何引用
你在 Project 视图中 Ctrl+多选一堆 .php 文件，右键 Refactor → Rename，输个新前缀，点 Refactor —— 这只是操作系统级重命名。它不会扫描 require 'user_model.php'，不会改 use App\Models\UserModel，也不会碰 composer.json 里的 autoload 映射。
- 适用场景：纯整理磁盘文件名（比如把
old_controller.php改成OldController.php），且确认项目中无硬编码路径或字符串引用 - 风险点：
require、include、new、class_alias等全部失效，运行时直接Warning: require(): failed to open stream - 如果你真这么做了，补救唯一方式是立刻用
Ctrl+Shift+R（Replace in Path）全局搜old_controller.php，替换成新名，但注意勾选Words only和Match case，避免误改old_controller_backup.php
想安全改名+同步更新引用？必须单文件逐个 Shift+F6
只有光标停在单个文件上按 Shift+F6，才能触发语义化重构：改文件名、更新 use、修正 require 路径、甚至调整 composer.json 的 PSR-4 映射（如果启用了相关选项）。
- 操作要点：右键单文件 → Refactor → Rename，或直接按
Shift+F6；输入新名后，务必勾选Search in comments and strings（否则硬编码路径如'models/user.php'不会更新） - 注意作用域：光标位置决定重构范围。放在
User.php文件里，它才去扫整个项目；放在某个子目录下选中文件再按Shift+F6，可能只扫当前目录 - 别跳过预览：点击
Preview查看所有将被修改的位置，尤其检查 vendor/ 是否被误包含（一般要手动排除）
批量移动零散文件到新目录？不能多选 Move，只能逐个 F6
你想把 UserController.php、UserService.php、UserRepository.php 一起拖进 src/Domain/User/，然后让 namespace 自动变成 App\Domain\User —— PhpStorm 会禁用 Refactor → Move 菜单项，或弹出 “Cannot move multiple files at once”。
立即学习“PHP免费学习笔记（深入）”；
- 可行路径：先在
src下建好Domain/User目录，并确保src已标记为 Sources Root；再对每个文件单独按F6（Move），目标选该目录 - namespace 更新有前提：原文件首行必须是
<?php，紧接着是namespace声明，中间不能有空行或declare；否则 Move 后 namespace 不变 - move 后
use语句大概率不会自动更新——比如其他文件里写的use App\Http\Controllers\UserController;，IDE 认为可能有同名类冲突，选择跳过。得靠Ctrl+Shift+R搜旧 namespace 手动替换
真正需要批量文件系统操作？别在 IDE 里硬刚，用脚本
要把 config.old.php 全改成 config.php，或者把 foo.txt 批量转成 foo.md，PhpStorm 不是干这个的。终端命令或 PHP 脚本更可控、可复现、易验证。
- Linux/macOS：用
rename命令，例如rename 's/\.old\.php$/.php/' *.old.php；注意不同系统的rename实现不同（Perl 版 vs util-linux 版），行为可能不一致 - Windows：PowerShell 更稳，
Get-ChildItem *.old.php | Rename-Item -NewName { $_.Name -replace '\.old\.php$', '.php' } - PHP 脚本关键点：用
pathinfo($file, PATHINFO_EXTENSION)提取原扩展名，用pathinfo($file, PATHINFO_FILENAME)拿文件名，再拼新路径；rename()必须检查返回值，失败时用error_get_last()查原因；目标路径写全，别依赖当前工作目录
最常被忽略的一点：无论你用什么方式改了类文件名或移动了目录，只要涉及 PSR-4 映射变更，就必须手动运行 composer dump-autoload，否则 Class not found 报错不会消失——这步和 PhpStorm 无关，是 Composer 的职责边界。
