PhpStorm 不支持批量重命名文件并同步更新引用，Refactor → Rename 仅对单文件生效且不更新 require/use；多文件改名需脚本或终端命令，语义级重构须逐个 Shift+F6，硬编码路径用 Ctrl+Shift+R 替换。
PhpStorm 无法安全地一次性批量重命名多个文件并同步更新所有引用——这是设计限制，不是操作不熟。你必须分清“改名”和“重构”是两件事，混用必出错。
Refactor → Rename 只对单个文件生效
右键多选一堆 UserController.php、PostController.php，再点 Refactor → Rename，IDE 会逐个弹窗让你输新名，不会自动把所有 *Controller.php 改成 *Handler.php。它也不更新任何 require 或 use 引用。
- 适用场景：你只想统一整理文件名（比如从下划线改成驼峰），且确认项目中没有硬编码路径调用这些文件
- 风险点：
require 'user_controller.php'不会变成require 'UserController.php'，运行时直接报Warning: require(): failed to open stream - 如果你真需要语义级更新（类名、命名空间、
use语句），只能一个一个来，对每个文件单独按Shift+F6，勾选Search in comments and strings
Replace in Path 是补救硬编码路径的唯一方式
批量改完文件名后发现大量 include 'config_old.php' 还没更新？这时候得靠 Ctrl+Shift+R（macOS 是 Cmd+Shift+R）做全局文本替换。
- 搜索填
config_old.php，替换为config.php，务必勾选Match case和Words only，避免把config_old.php.bak错替成config.php.bak - 先点
Find预览所有匹配项，重点检查是否命中了注释、日志字符串或第三方库代码 - 动态拼接的路径（如
$path = __DIR__ . '/config/' . $env . '_old.php';）无法被覆盖，这种必须人工检查逻辑
按后缀批量改名必须用脚本或终端命令
想把整个 models/ 目录下所有 .old.php 改成 .php？PhpStorm 没这个功能。别在 IDE 里折腾宏或正则重命名，直接用 PHP 脚本或 shell 命令更可控。
立即学习“PHP免费学习笔记（深入）”；
- PHP 脚本推荐用
glob($dir . '/*.old.php')，不用scandir()——避免遍历.、..和子目录 - 新文件名必须用
pathinfo($file, PATHINFO_FILENAME)提取原名，再拼扩展名；不能用str_replace('.old.php', '.php', $file)，否则readme.old.php.bak会变成readme.php.bak - Linux/macOS 终端可用
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' }
Move 重构不支持多选 PHP 文件
想把零散的几个 .php 文件一起挪进新目录并自动更新 namespace？不行。PhpStorm 的 Refactor → Move 只接受单文件或整个目录作为单位。
- 多选后右键 →
Refactor → Move要么禁用，要么报错“Cannot move multiple files at once” - 可行路径：先手动建好目标目录（如
src/Domain/User），确保它和期望命名空间严格对应（App\Domain\User）；再对每个文件单独F6→ Move，每次 Move 后检查namespace是否已更新 -
use语句不一定自动更新——如果项目里存在同名类（哪怕不同命名空间），IDE 会跳过修改，避免歧义
最易被忽略的是：重命名类文件后，composer.json 里的 PSR-4 映射路径不会自动更新，必须手动运行 composer dump-autoload，否则 Class not found 就来了。
