PhpStorm不支持选中多个.php文件一键重命名并自动更新所有引用；必须分步操作：单文件用Shift+F6重构更新引用，批量改名后用Replace in Path补救路径字符串，纯后缀替换应使用终端命令或PHP脚本，且类文件重命名后须手动执行composer dump-autoload。
PhpStorm 本身不支持“选中一堆 .php 文件 → 一键改成新名字 + 自动更新所有 require、use、命名空间”的批量重命名。你想要的其实是两个独立动作：文件系统改名、代码引用更新——它们必须分开做，且不能跳过验证。
Refactor → Rename 只对单个文件生效，多选等于白忙
你在 Project 视图里 Ctrl+多选十几个 .php 文件，右键 → Refactor → Rename，IDE 会弹出一个带编号的列表（file_1.php、file_2.php…），但它：
- 只改文件名，完全不扫描或更新任何代码中的路径、类名、
use语句 - 不会识别
require 'old_name.php'这种硬编码字符串 - 更不会碰
class_exists('OldName')或路由注解里的字符串 - 如果你勾选了
Search in comments and strings，它也只是在当前选中文件里搜，不是全项目
想安全改名 + 同步更新引用？只能一个个来
真正能兼顾文件名和引用的，只有对每个文件单独执行 Shift+F6：
- 光标停在
User.php文件名上 →Shift+F6→ 输入Member.php - 勾选
Search in comments and strings（覆盖硬编码路径）和Search for text occurrences（覆盖注释/日志里的示例） - 点
Find预览所有待更新位置，确认没误触 vendor 或配置项 - 执行后，
use App\Models\User会变成use App\Models\Member，new User()也会同步变 - 但注意：
composer.json中 PSR-4 映射的路径不会自动更新，改完必须手动运行composer dump-autoload
批量改名后发现引用漏了？用 Replace in Path 补救
如果已经用多选 Rename 把一堆 config_old.php 改成 config_new.php，但代码里还满是 require 'config_old.php'，就靠 Ctrl+Shift+R（Windows/Linux）或 Cmd+Shift+R（macOS）：
立即学习“PHP免费学习笔记（深入）”；
- Scope 选中目标目录（比如只改
app/，别让vendor/被波及） - File mask 填
*.php，避免误改.env或package.json - 搜索填
config_old.php，替换填config_new.php，务必勾选Words only - 先点
Find—— 重点看匹配项是否都在require、include、use行，而不是在 SQL 字符串或注释里 - 动态拼接的路径（如
$path = __DIR__ . '/config_' . $env . '.php';）无法被覆盖，得人工检查逻辑
纯后缀批量替换？别在 PhpStorm 里硬刚，用终端或脚本
只想把所有 .old.php 改成 .new.php，不关心引用更新，那就彻底放弃 IDE GUI：
- Linux/macOS：
rename 's/\.old\.php$/.new.php/' *.old.php（注意：不同系统rename实现不同，Perl 版才支持正则） - Windows PowerShell：
Get-ChildItem *.old.php | Rename-Item -NewName { $_.Name -replace '\.old\.php$', '.new.php' } - PHP 脚本更可控：用
glob('*.old.php')获取文件，pathinfo($file, PATHINFO_FILENAME)提取原名，再拼.new.php；rename()前必须检查!file_exists($newPath)，否则同名就静默失败
最易忽略的一点：无论用哪种方式批量改名，只要涉及类文件移动或重命名，composer dump-autoload 就不是可选项，是必跑命令——否则 Class not found 报错会直接卡住整个流程。
