PhpStorm不支持多选文件一键重命名并更新引用；批量改名仅变更文件名，需单文件用Shift+F6才能同步更新路径、use语句等；改后缀需外部脚本；遗漏引用须用Ctrl+Shift+R补救。
PhpStorm 本身不支持“选中一堆文件 → 一键重命名并自动更新所有引用”的操作。所谓“批量重命名文件”，实际要拆成两种完全不同的需求：一种是只改文件名（比如 user_model.php → UserModel.php），另一种是改名+同步更新代码里所有路径和类引用（比如 require 'user_model.php' 和 use App\Models\UserModel）。混淆这两者，90% 的人会遇到运行时报错或引用失效。
多选文件 Rename 只改名，不更新任何引用
很多人在 Project 视图中 Ctrl+多选一堆 .php 文件，右键 → Refactor → Rename，以为能统一改名并修复路径——结果只是文件系统名字变了，require、use、new 全都没动，运行直接报 Warning: require(): failed to open stream。
- 这个操作本质是“批量文件系统重命名”，PhpStorm 不扫描、不分析、不重构任何代码逻辑
- 适用场景仅限：你确认这些文件在项目中无硬编码路径调用，或你准备手动补救
- 输入新名时，PhpStorm 会默认加序号（
file_1.php、file_2.php），必须逐个编辑名称列表才能对齐预期格式 - 它不会校验目标路径是否已存在同名文件，也不提示冲突，失败时静默跳过
想安全改名+更新引用，必须单文件用 Shift+F6
这是唯一能保证语义一致性的方式：Shift+F6 会对当前文件执行完整重构：改文件名、更新 require/include 路径、修正 use 语句、调整命名空间（如果移动目录）、甚至更新 composer.json 中的 autoload 映射（需启用选项）。
- 光标必须停在你要重命名的文件上（不是选中，是点击定位），再按
Shift+F6 - 勾选
Search in comments and strings才能捕获硬编码路径（如require 'old_name.php'） - 勾选
Search for text occurrences才能匹配注释、日志、JSON 字段等非结构化文本中的字符串 - 执行前务必点
Find预览所有变更点——尤其注意 vendor/、tests/、config/ 下是否误命中
批量改后缀（如 .old.php → .php）得靠外部脚本或终端
PhpStorm 没有“按扩展名筛选并统一替换”的功能。右键多选 → Rename 不会识别 .old.php 这类模式，也不会自动推导新扩展名。
立即学习“PHP免费学习笔记（深入）”；
- Linux/macOS 推荐用
rename命令：rename 's/\.old\.php$/.php/' *.old.php，但注意不同系统rename实现不同（Perl 版 vs util-linux 版） - Windows 用户用 PowerShell：
Get-ChildItem *.old.php | Rename-Item -NewName { $_.Name -replace '\.old\.php$', '.php' } - PHP 脚本更可控：用
glob($dir . '/*.old.php')获取文件列表，pathinfo($file, PATHINFO_FILENAME)提取原名，再拼.php，最后用rename()并检查返回值 - 无论哪种方式，改完后都必须人工跑
Ctrl+Shift+R（Replace in Path）搜.old.php，补全漏掉的硬编码路径
补救遗漏的路径引用，只能靠 Ctrl+Shift+R
即使你老老实实一个一个用 Shift+F6，仍可能漏掉动态拼接路径（如 $path = __DIR__ . '/models/' . $name . '.old.php';）或配置文件里的字符串。这时候 Ctrl+Shift+R 是唯一兜底手段。
- 一定要先选中目标目录（如
app/），再按快捷键，避免误改vendor/或node_modules/ -
File mask必须填明确值，比如*.{php,html,js,yaml}，不能留空或填php - 勾选
Match case和Words only：否则config.old.php可能被替成config.php.bak里的.old.php子串 - 别跳过
Find步骤——require 'user.old.php'和// example: user.old.php都会匹配，但后者不该动
最常被忽略的一点：文件移动或重命名后，如果涉及 PSR-4 类映射变更（比如从 app/Models/User.php 移到 src/Domain/User.php），composer dump-autoload 必须手动执行，否则 Class not found 报错不会告诉你问题出在哪。
