PhpStorm不支持批量重命名文件并自动更新引用，多选Rename仅改文件名；安全做法是单文件Shift+F6，基于AST更新use、require、new等所有引用，并需手动执行composer dump-autoload。
PhpStorm 本身不支持“批量重命名多个文件并自动更新所有引用”这一操作——你选中十个 .php 文件右键 Refactor → Rename，它只会挨个弹窗改名，且完全不扫描或更新任何 require、use、硬编码路径或类名调用。这不是功能缺失，而是设计使然：语义化重构（如 Shift+F6）必须单文件逐个执行，才能准确推导作用域、命名空间和依赖关系。
多选文件 Rename 只改名，不更新任何引用
这是最常踩的坑。你在 Project 视图中 Ctrl+鼠标 多选 User.php、Post.php、Comment.php，右键 Refactor → Rename，输入 Model.php，结果得到 UserModel.php、PostModel.php……但所有 require 'User.php' 还在原地，new User() 依然报错。
- 该操作本质是文件系统级重命名，等价于在终端执行
mv User.php UserModel.php - 不会触发任何代码扫描，
Search in comments and strings等选项在此场景下完全不生效 - 适用场景仅限：纯整理文件名（如统一加前缀），且你确认项目中无硬编码路径或类名引用
- 若已有
require 'User.php'，改名后必须人工补救，否则运行时直接Warning: require(): failed to open stream
想安全改名 + 同步更新引用？只能单文件 Shift+F6
真正能自动更新 use、new、require、命名空间、甚至 composer.json autoload 映射的，只有单文件 Shift+F6。它基于 AST 分析，不是字符串替换。
- 光标停在
User.php文件名上（Project 视图或编辑器 tab），按Shift+F6 - 输入新名（如
UserModel.php），勾选Search in comments and strings（覆盖require 'User.php'类路径）和Search for text occurrences（覆盖注释/日志里的示例） - 点击
Preview查看所有待更新位置，确认无误再点Refactor - 如果文件属于 PSR-4 自动加载路径，且
composer.json已配置，重命名后需手动运行composer dump-autoload，否则Class not found
批量改后缀（如 .old.php → .php）必须用脚本或终端
PhpStorm 没有“按扩展名批量重命名”的功能。所谓“宏”或“正则批量改名”在 IDE 内不可靠，也不存在。
立即学习“PHP免费学习笔记（深入）”；
- Linux/macOS：用
rename命令，例如rename 's/\.old\.php$/.php/' *.old.php（注意 Perl 版与 util-linux 版行为差异） - Windows：PowerShell 更稳，
Get-ChildItem *.old.php | Rename-Item -NewName { $_.Name -replace '\.old\.php$', '.php' } - PHP 脚本更可控（推荐）：
foreach (glob(__DIR__ . '/*.old.php') as $file) { $info = pathinfo($file); $newPath = $info['dirname'] . '/' . $info['filename'] . '.php'; if (!file_exists($newPath) && !rename($file, $newPath)) { echo "失败: $file → $newPath\n"; } }关键点：pathinfo()提取原名，不用str_replace()；rename()必须检查返回值；目标路径必须写全
改名后引用没更新？用 Replace in Path 补救
无论你用哪种方式改了文件名，只要发现 require、include 或配置里还有旧路径，就得靠 Ctrl+Shift+R（macOS 是 Cmd+Shift+R）来全局修复。
- 先选中目标目录（如只修
app/下的引用），再按快捷键，避免误触vendor/ - File mask 填
*.php，确保只扫 PHP 文件；别留空或填php - 搜索内容填
User.php，替换为UserModel.php，务必勾选Words only和Match case - 动态拼接路径（如
$path = __DIR__ . '/models/' . $name . '.php'）无法被覆盖，必须人工检查逻辑 - 预览（
Find）比直接Replace All安全十倍——尤其注意是否命中了.bak、.log或注释里的示例
最容易被忽略的是：文件移动或重命名后，composer dump-autoload 不是可选项，是必选项；而 Replace in Path 对动态路径、反射调用、JSON 字段名完全无效，这些地方只能靠人工核对或正则辅助。
