PhpStorm不支持批量重命名多个类，必须逐个用Shift+F6在类名上重构以同步更新引用；字符串引用、配置、注释等需Replace in Path补漏；最后务必执行composer dump-autoload刷新自动加载。
批量重命名多个类？PhpStorm根本不支持
别试了——PhpStorm 没有“选中 10 个 .php 文件，一键把所有类名从 UserModel 改成 UserEntity”的功能。你右键多选 → Refactor → Rename，它只会挨个弹窗让你输新名，且每个文件的重构彼此隔离：改完 UserModel.php，PostModel.php 里的 new UserModel() 不会自动变成 new UserEntity()。
想安全改多个类名，必须一个一个来，用 Shift+F6
这是唯一能同步更新引用的方式，包括：use 语句、new 调用、继承关系、类型提示、甚至部分 composer.json autoload 映射（如果启用了相关选项）。
- 光标必须停在类名上（比如
class UserModel的UserModel），不能选中整行或整个文件 - 勾选
Search in comments and strings—— 否则require 'UserModel.php'这种硬编码路径不会被更新 - 勾选
Search for text occurrences—— 覆盖注释里写的示例、文档字符串里的类名引用 - 点
Preview看所有待改位置，确认没误触第三方库或测试数据
改完一批类名后，Replace in Path 是补漏刚需
重构只管“语义上可识别”的引用，以下情况它完全不管：
-
class_exists('UserModel')或app('UserModel')这类字符串参数 - JSON 配置里写的
"model": "UserModel" - SQL 查询字符串中的表别名或注释
- 路由定义里的控制器名（如
@Get("/users")注解不触发重构）
这时必须用 Ctrl+Shift+R（Windows/Linux）或 Cmd+Shift+R（macOS）打开 Replace in Path，填入 UserModel → UserEntity，限定 File mask: *.php，并勾选 Match case 和 Words only 避免把 UserModelHelper 错改成 UserEntityHelper。
立即学习“PHP免费学习笔记（深入）”；
最易忽略但必做的一步：composer dump-autoload
类文件移动或重命名后，Composer 的自动加载映射不会自动刷新。即使代码里 use App\Models\UserEntity; 写对了，运行时仍可能报 Class not found。
- 改完所有类文件和引用后，在终端执行
composer dump-autoload - 如果改了命名空间路径（比如从
App\Models移到App\Entities），还得同步更新composer.json里的autoload.psr-4配置项 - 不跑这步，本地可能暂时“看着正常”，CI 或部署环境必然失败
