PhpStorm不支持按后缀名批量重命名文件；Refactor→Rename（Shift+F6）仅支持单文件语义化重命名并同步更新引用，多选重命名仅改名不更新引用；按后缀批量改名需用PHP脚本或终端命令（如Linux的rename、PowerShell的Rename-Item）。
PhpStorm 里不能直接按后缀名批量重命名文件
别被“批量”误导——PhpStorm 的 Refactor → Rename（Shift+F6）只作用于单个文件，且重命名时会同步更新代码中所有引用（如 require、use、硬编码路径等），但它**不支持按 .php、.js 这类后缀筛选并统一改名**。你右键多选一堆 .old.php 文件，点 Rename，它只会挨个弹窗让你输新名，不会自动把所有 .old.php 批量变成 .new.php。
真正能按后缀批量改名的只有两种可靠方式
一种是用 PHP 脚本在命令行跑，一种是在终端用 shell 命令。PhpStorm 自身没这个功能，强行在 IDE 里折腾只会浪费时间。
- PHP 脚本适合需要逻辑判断的场景：比如只改某子目录下、带特定前缀、扩展名长度大于 3 的文件，或要保留原始时间戳
- Linux/macOS 终端用
rename命令最干脆：例如rename 's/\.old\.php$/.new.php/' *.old.php，但注意不同系统自带的rename实现不同（Perl 版 vs util-linux 版），行为可能不一致 - Windows 用户建议用 PowerShell：
Get-ChildItem *.old.php | Rename-Item -NewName { $_.Name -replace '\.old\.php$', '.new.php' }
用 PHP 脚本改后缀时，pathinfo() 和 rename() 必须配对用
很多人漏掉关键一步：只改了文件名，却没验证路径是否合法，结果重命名失败还找不到原因。
- 必须用
pathinfo($file, PATHINFO_EXTENSION)提取原扩展名，再拼新名，不能靠str_replace('.old.php', '.new.php', $file)——万一文件名里有old.php字样（比如my_old.php_config.php）就炸了 -
rename()返回布尔值，一定要检查：if (!rename($oldPath, $newPath)) { echo "失败: $oldPath → $newPath (".error_get_last()['message'].")\n"; } - 目标路径必须写全，
rename('a.php', 'b.txt')在当前目录有效，但跨目录必须带路径，否则会被当成相对当前工作目录，不是你 Project 视图里看到的那个“当前”
重构改名和后缀批量改名根本不是一回事
这是最容易混淆的点：你在 PhpStorm 里用 Shift+F6 把 User.php 改成 Member.php，它会自动更新 new User()、use App\Models\User;、甚至 composer.json 里的 autoload 映射（如果启用了相关选项）。但如果你只是想把 config.old.php 全改成 config.php，这属于文件系统操作，跟 PHP 语义无关，PhpStorm 不会、也不该去动你的 require 语句——因为那些字符串可能是动态拼的，也可能是注释里的示例。
立即学习“PHP免费学习笔记（深入）”；
真要兼顾两者，得先用脚本批量改后缀，再进 PhpStorm 对每个新文件手动触发一次 Refactor → Rename（哪怕名字没变），勾选 Search in comments and strings，让它扫一遍硬编码路径并更新。
