Refactor → Rename仅支持单文件语义化重命名并同步更新引用；多选批量重命名仅修改文件名，不更新use、new等任何代码引用，必须逐个使用Shift+F6重构，再用Replace in Path补漏。
Refactor → Rename 只对单个文件生效，多选不更新引用
想把 UserModel.php、PostModel.php、CommentModel.php 全部改成 User.php、Post.php、Comment.php，并自动更新所有 use、new、extends 等引用？别用多选右键 → Refactor → Rename。这个操作只会改文件名，完全不扫描代码——use App\Models\UserModel; 依然存在，运行时直接报 Class 'App\Models\UserModel' not found。
根本原因：PhpStorm 的重构引擎是语义驱动的，必须逐个解析类定义、命名空间、调用上下文。它无法为多个文件同时建立一致的重命名映射关系。
- 多选后 Rename，IDE 实际上禁用重构逻辑，退化为纯文件系统重命名
- 即使成功改名，
composer dump-autoload也救不了——旧类名在代码中还大量残留 - 唯一能触发引用同步更新的入口，只有单文件上的
Shift+F6
批量改类名必须拆解为“单文件重构 + 路径补漏”两步
安全路径只有一条：一个一个来，但可以高效组织。核心是让每个 Shift+F6 都真正起效，再用文本替换兜底。
- 先确保目标类文件首行是
<?php，紧接着就是namespace，中间不能有空行或declare—— 否则 PhpStorm 可能识别不出命名空间，导致use语句不更新 - 对
UserModel.php按Shift+F6，输入User.php，勾选Search in comments and strings（硬编码路径如require 'UserModel.php'才会被扫到） - 执行前点
Preview，确认所有new UserModel()、use UserModel;、class Post extends UserModel都列在其中 - 改完一个后，立刻运行
composer dump-autoload，验证是否能正常加载新类名 - 遗漏的字符串路径（比如配置数组里的
'model' => 'UserModel'）必须靠Ctrl+Shift+R补：搜索UserModel，替换为User，Scope 限定在app/，File mask 填*.{php,phpstorm}，务必勾选Words only
Replace in Path 替换类名时，Words only 和 Match case 是生死线
Ctrl+Shift+R 不是万能锤，乱用会把项目敲散。类名替换尤其敏感，大小写和词边界稍错一点，Username 就变 Username→Username 或 Useradmin。
立即学习“PHP免费学习笔记（深入）”；
-
Words only必须勾选：否则UserModel会误伤SuperUserModel、UserModelFactory里的子串 -
Match case必须勾选：PHP 类名区分大小写，UserModel和usermodel是两个东西；不勾它，可能把常量USER_MODEL也替成USER_USER - 别信 File mask 保命：填
*.php只过滤后缀，vendor/ 下的同名类仍可能被扫到——Scope 必须手动设为Project Files（默认不含 vendor）或自定义目录 - JSON/YAML 配置里出现的类名字符串（如 Laravel 的
config/app.php中的'providers' => [...]）不会被重构捕获，必须单独加进 Replace in Path 的 Scope 并显式指定*.{json,yaml,yml}
动态调用、反射、字符串键名永远不在重构覆盖范围内
哪怕你把所有 UserModel 类文件都 Shift+F6 改完了，以下几处照样崩：
-
class_exists('App\Models\UserModel')→ 仍返回false，得手动搜'UserModel'字符串替换 -
app('App\Models\UserModel')、resolve('App\Models\UserModel')→ 同样是字符串，重构无感知 -
$service = 'UserModel'; $obj = new $service();→ 动态实例化，静态分析无法追踪 - Laravel 路由注解
@Get("/users")里如果写了@Middleware(UserModel::class)，::class语法虽能被识别，但若写成@Middleware('UserModel')就彻底漏掉 - 数据库迁移里
$table->foreignIdFor(UserModel::class)改完类名后不会自动更新，需人工检查或正则匹配foreignIdFor\([^)]*UserModel
这些地方没有捷径，只能靠 Ctrl+Shift+F 全局搜原类名字符串，逐个判断上下文是否需要改——最易忽略的是测试文件里的 mock(UserModel::class) 和工厂类里的 return new UserModel();。
