phpstorm的refactor→rename仅支持单文件或单目录安全重命名并同步更新所有语义引用，多选时菜单禁用或仅逐个弹窗改名，不推导规则、不跨文件更新路径字符串。
Refactor → Rename 只对单个文件或目录生效
PhpStorm 的 Refactor → Rename（快捷键 Shift+F6）能安全更新所有语义引用，但只支持单目标操作。你 Ctrl+多选一堆目录或文件后点 Rename，IDE 会禁用该菜单，或仅允许逐个弹窗输入新名——它不会批量推导规则，更不会自动同步路径字符串。
适用场景：想把 UserController.php 改成 MemberController.php，同时更新 use App\Http\Controllers\UserController;、new UserController()、路由定义里的类名引用。
常见错误现象：
- 多选后右键出现灰色的 Refactor → Rename 选项
- 点击后弹出多个重命名对话框，每个都要手动输名，且不共享逻辑
- 误以为勾选 Search in comments and strings 就能覆盖所有硬编码路径，其实它只扫当前文件内字符串，不跨文件
多选重命名 = 文件系统改名，零引用更新
在 Project 视图中按住 Ctrl（Windows/Linux）或 Cmd（macOS）多选文件/目录，右键 → Refactor → Rename，输入新名后点击 Refactor，结果只是文件系统层面的重命名。
这一步完全不扫描代码，也不修改任何 require、include、use、new 或配置项中的路径字符串。运行时立刻报错是常态。
必须配合以下补救动作：
- 立即执行 Ctrl+Shift+R（macOS 是 Cmd+Shift+R）打开 Replace in Path
- 搜索旧路径字符串（如 'controllers/user.php'），替换为新路径（如 'controllers/member.php'）
- 勾选 Match case 和 Words only，避免把 user_config.php 错替成 member_config.php
- 务必先点 Find 预览全部匹配项，重点排查注释、日志、JSON 数据、第三方库路径
Move 重构不支持多选，且命名空间更新有硬性前提
想把零散的 User.php、Role.php、Permission.php 一起挪进 src/Domain/Auth/？别试多选 → Refactor → Move。PhpStorm 直接禁用该菜单，或提示“Cannot move multiple files at once”。
真正可行的路径是分步操作：
- 先确保目标目录（如 src/Domain/Auth）已被标记为 Sources Root（右键 → Mark Directory as → Sources Root）
- 每个文件单独 F6 → Move，目标选 src/Domain/Auth
- 移动后立即检查：文件首行是否为 <?php 后紧跟 namespace，中间不能有空行或 declare；否则 namespace 不会自动更新
- use 语句大概率不会被更新——即使移动成功，其他文件里仍保留旧 use App\Models\User;，得靠 Ctrl+Shift+R 手动扫
动态路径（如 $path = __DIR__ . '/models/' . $class . '.php';）和字符串类名（如 class_exists('AppModelsUser')）永远不在 Move 重构覆盖范围内。
批量改后缀必须用脚本或终端命令
PhpStorm 没有“按 .old.php 批量改成 .new.php”的功能。所谓宏、正则重命名在 IDE 内部根本不存在。强行折腾只会浪费时间。
可靠方案只有两个：
- Linux/macOS 终端：rename 's/\.old\.php$/.new.php/' *.old.php（注意 Perl 版 rename 才支持正则，util-linux 版不支持）
- Windows PowerShell：Get-ChildItem *.old.php | Rename-Item -NewName { $_.Name -replace '\.old\.php$', '.new.php' }
- PHP 脚本（推荐用于需校验、跳过子目录、保留时间戳等场景）：
用 glob($dir . '/*.old.php') 而非 scandir()，避免遍历 .、..
提取原名必须用 pathinfo($file, PATHINFO_FILENAME) + 拼扩展名，不能 str_replace() —— 否则 config.old.php.bak 会变成 config.new.php.bak
>调用 rename() 前必须检查返回值：if (!rename($oldPath, $newPath)) { /* 报错 */ }
脚本不碰代码引用，所以改完后还得走一遍 Replace in Path 补路径字符串——这是最容易漏掉的一环。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
