PhpStorm不支持一键批量重命名并同步更新引用，仅Shift+F6单文件语义重构可安全更新所有代码引用；多选重命名仅改系统文件名，不更新代码；批量改名后需用Ctrl+Shift+R补漏；改扩展名推荐脚本处理；重命名后必须执行composer dump-autoload。
PhpStorm 没有“一键批量重命名多个文件并同步更新所有引用”的功能。所谓“批量重命名”，实际是三种不同操作的混淆：单文件语义重构、多文件系统改名、全局文本替换——用错场景，轻则路径报错，重则项目崩溃。
Refactor → Rename（Shift+F6）只对单个文件安全有效
这是唯一能自动更新 require、use、命名空间、类调用、甚至 composer.json autoload 映射的途径，但必须逐个操作：
- 光标放在目标文件名上（如
User.php），按Shift+F6 - 输入新名（如
Member.php），勾选Search in comments and strings（硬编码路径需覆盖） - 点击
Refactor前务必看预览列表——确认所有变更点都在你预期范围内 - 若文件被
require 'models/user.php'硬引用，且该字符串未勾选搜索项，则不会更新
多选文件右键 Rename 仅改名，不碰任何代码引用
你在 Project 视图中 Ctrl+多选一堆 .php 文件，再右键 → Refactor → Rename，IDE 会为每个文件生成独立重命名弹窗，但：
- 它只调用系统
rename()，完全不扫描项目内任何include、new User()或配置项 - 适用场景极窄：纯整理文件系统（如把
user_model.php改成UserModel.php），且你 100% 确认无硬编码路径 - 一旦存在
require 'user_model.php'，运行时直接报Warning: require(): failed to open stream
Replace in Path（Ctrl+Shift+R）是补漏的唯一手段
批量改完文件名后发现引用没更新？必须靠这个对话框手动救火：
立即学习“PHP免费学习笔记（深入）”；
- 先在 Project 视图中选中目标目录（如
app/），再按Ctrl+Shift+R，范围自动锁定，避免误触vendor/ -
File mask必须填*.php（不是php），否则 JSON、.env、.gitignore 全被扫进来 - 搜索
user_model.php，替换为UserModel.php，务必勾选Words only和Match case - 动态拼接路径（如
$path = __DIR__ . '/models/' . $name . '.php';）无法被覆盖，只能人工检查逻辑
PHP 脚本才是可控的后缀批量替换方案
如果目标只是统一改扩展名（如 .old.php → .php），别在 PhpStorm 里折腾 GUI —— 写个脚本更透明、可复现、防误操作：
- 用
glob($dir . '/*.old.php')获取文件列表，比scandir()更干净，不混入.、.. - 必须用
pathinfo($file, PATHINFO_FILENAME)提取原名，再拼.php，禁用str_replace('.old.php', '.php', $file)（否则config.old.php.bak变成config.php.bak） -
rename()返回布尔值，必须检查：if (!rename($oldPath, $newPath)) { /* 记录失败原因 */ } - 目标路径必须写全，
rename('a.old.php', 'a.php')在当前工作目录生效，跨目录必须带完整路径
最常被跳过的一步：类文件移动或重命名后，composer dump-autoload 不执行，Class not found 就必然发生——这不是 PhpStorm 的问题，而是 PSR-4 自动加载机制的刚性要求。
