PhpStorm不支持一键批量重命名多个文件并同步更新所有引用；必须分三步：单文件Shift+F6重构改名及引用、脚本或终端批量改后缀、Replace in Path补漏路径字符串。
PhpStorm 里没有“一键批量重命名多个文件 + 同步更新所有类名和引用”的功能。所谓“批量”，必须拆解为不同动作：文件系统层改名、语义层重构、文本层补漏，三者不可混用，也不能跳步。
Refactor → Rename 只对单个文件生效，多选=仅改名不更新引用
你在 Project 视图中 Ctrl+多选一堆 User.php、Post.php，右键选 Refactor → Rename，IDE 会挨个弹窗让你输新名（如 UserModel.php），但它不会扫描任何代码里的 require 'User.php' 或 use App\User;。这本质是批量文件重命名，不是重构。
- 适用场景：整理文件名（比如统一加
Controller后缀），且你确认项目中无硬编码路径或use引用 - 风险点：改完后运行直接报错
Warning: require(): failed to open stream，因为路径字符串全没变 - 别指望它自动改类名——文件名和类名在 PHP 中是解耦的，
Foo.php里完全可以定义class Bar
想安全改类名？必须对每个文件单独执行 Shift+F6
光标停在 User.php 的类名 User 上，按 Shift+F6，输入 UserModel，勾选 Search in comments and strings 和 Search for text occurrences，才能让 IDE 扫描并更新：new User()、use App\User;、class extends User、甚至注释里的 // @see User。
- 每次只作用于一个符号：光标在
$user变量上，就只改变量；在class User上，才改类定义和所有引用 - 动态调用漏网：比如
app('User')、class_exists('User')、$_POST['User']不会被捕获，得靠Ctrl+Shift+R补搜 - 改完类名后，
composer.json里 PSR-4 映射的路径不会自动更新，必须手动运行composer dump-autoload
批量改文件后缀（如 .old.php → .php）只能靠终端或 PHP 脚本
PhpStorm 自身不支持按扩展名筛选并统一替换后缀。Refactor → Rename 对 *.old.php 文件无效；宏录制也做不到路径级批量操作。
立即学习“PHP免费学习笔记（深入）”；
- Linux/macOS 推荐用
rename命令：rename 's/\.old\.php$/.php/' *.old.php，但注意系统自带版本差异（Perl vs util-linux） - Windows 用 PowerShell：
Get-ChildItem *.old.php | Rename-Item -NewName { $_.Name -replace '\.old\.php$', '.php' } - PHP 脚本更可控：用
glob('*.old.php')+pathinfo($file, PATHINFO_FILENAME)拼新名，绝不能用str_replace('.old.php', '.php', $file)——否则config.old.php.bak会变成config.php.bak - 脚本里必须检查
rename()返回值：if (!rename($old, $new)) { /* 失败日志 */ }，否则静默失败
补漏必须用 Replace in Path（Ctrl+Shift+R），但范围要锁死
文件名和类名都改完后，大量硬编码路径、字符串键名、配置项仍残留旧名。这时候唯一能扫全项目的操作是 Ctrl+Shift+R（Windows/Linux）或 Cmd+Shift+R（macOS）。
- Scope 必须手动设为
Project或自定义目录，不能依赖默认值——默认可能不含config/或resources/ - File mask 填
*.{php,html,js,yaml,json}，而不是php或留空；否则.env或package.json会被误改 - 勾选
Words only防子串污染：把user替成admin时，username不会变成adminname - 正则替换注意捕获组写法：
echo\s+'([^']+)';→Log::info('$1');，用$1，不是\1
最易被忽略的是：文件移动（Move）、重命名（Rename）、复制（F5）三者触发的语义更新能力完全不同。Move 会尝试修正 namespace，Rename 会更新引用，F5 复制只动文件系统——混用就会漏掉关键环节，而 PhpStorm 不会警告你漏了什么。
