必须用shift+f6逐个重构php类名与文件名，否则仅改文件名导致use、new、命名空间等全部失效；它自动同步更新类名、文件名、namespace、use语句、类型提示及composer.json的psr-4映射。
不能用多选文件 + Refactor → Rename 一次性改类名和文件名，那样只改文件系统名字，所有 use、new、命名空间、require 全部失效——这是最常踩的坑。
单个 PHP 类文件必须用 Shift+F6 逐个重构
PhpStorm 的类名与文件名联动更新，只在单文件 Refactor → Rename（Shift+F6）时触发。它会同时改：文件名、类名、namespace（如果移动目录）、所有 use 语句、new ClassName()、类型提示、甚至 composer.json 中的 PSR-4 映射（若启用选项）。
- 光标必须停在类名上（比如
User），不能停在文件名或路径上，否则只改文件不改类 - 勾选
Search in comments and strings才能捕获硬编码路径，如require 'User.php' - 如果类里有
class_alias('OldName', 'NewName')或字符串反射（class_exists('OldName')），这些不会被自动更新，得靠Ctrl+Shift+R补漏 - 改完后务必运行
composer dump-autoload，否则Class not found报错大概率出现
批量改多个类？别幻想“一键全换”，得拆成两步走
想把 User、Post、Comment 全部重命名为 Member、Article、Tag，PhpStorm 不支持映射式批量重构。强行多选再 Rename，结果只是把三个文件分别改成 Member.php、Article.php、Tag.php，而它们内部的 class User 还是 User，引用也全断。
- 第一步：对每个文件单独执行
Shift+F6，输入新文件名（如Member.php），IDE 自动同步改类名和引用 - 第二步：如果新类名之间有共性（比如都加
Legacy前缀），可在每步中手动编辑新名；但无法让 IDE 自动推导“User→Member”这种非规则映射 - 若只是统一加前缀/后缀（如全部加
V2），可用Ctrl+Shift+R全局替换类名字符串，但必须勾选Words only和Match case，并预览所有匹配项——尤其避开vendor/目录
Replace in Path 是补漏主力，不是替代方案
即使每个文件都用 Shift+F6 改过，仍有三类地方永远漏掉：class_exists('User')、app('UserRepository')、JSON 配置里的 "model": "User"。这些必须靠 Ctrl+Shift+R（Windows/Linux）或 Cmd+Shift+R（macOS）人工扫。
- Scope 一定要设为 Project 或自定义目录，别留在 Current File
- File mask 填
*.{php,json,yaml}覆盖常见配置格式 - 搜索内容用正则
'User'或"User"，避免误触username；用\bUser\b更安全 - 动态拼接的类名（如
$class = $prefix . 'User'）无法被静态分析覆盖，只能靠代码逻辑审查
真正麻烦的从来不是改名动作本身，而是那些没被 IDE 索引到的字符串上下文——它们藏在配置、注释、SQL、日志模板甚至第三方 SDK 的回调里，不逐层验证，上线就报错。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
