Shift+F6重命名类必然报错，因PHPStorm无法处理容器字符串引用、PSR-4映射未更新、注解及trait引入等动态场景，需手动补全dump-autoload、grep替换和use语句修正。
直接改类名几乎必然报错，因为 PhpStorm 的 Shift+F6 重构只改静态可推断的引用，而 PHP 项目里大量关键调用点（如容器解析、路由注解、字符串类名）根本不在它的索引范围内。
为什么 Shift+F6 重命名类后还 Class not found
这不是重构失败，是 PhpStorm 静态分析天然覆盖不到的地方漏了：
-
app('OldService')、resolve('OldService')这类字符串形式的容器绑定，完全不参与重构，必须手动 grep 替换 - 类文件从
app/Services/OldService.php移到app/Services/NewService.php后，composer.json里的 PSR-4 映射没变，autoloader 找不到新路径，得立刻运行composer dump-autoload -
@Get("/old-service")、@deprecated OldService::do()这类注解内容不会更新，IDE 也不提示 - 如果旧类被
trait引入且子类重写了同名方法，Shift+F6会弹窗问“是否更新子类”，但子类方法签名可能已不兼容新类，不能直接点 OK
重命名前必须验证的三件事
别急着按 Refactor，先确认上下文是否完整：
- 把光标停在类名上，按
Ctrl+Click—— 能跳转到定义才说明 IDE 已正确索引该类；跳不到，先检查 PHP 解释器配置和 autoload 是否生效 - 打开
composer.json，确认"psr-4"映射存在且路径与实际目录结构一致（比如"App\": "app/"对应app/Services/OldService.php） - 右键目标目录 →
Mark Directory as → Sources Root，否则 Move 或 Rename 都不会触发命名空间同步
重命名后必须手动补的三个动作
重构窗口点完 Refactor 不等于结束，漏掉任何一项都可能 runtime 报错：
立即学习“PHP免费学习笔记（深入）”；
- 进终端，cd 到项目根目录，执行
composer dump-autoload—— 这步跳过，90% 的Class not found就来自这里 - 全局搜原类名：
grep -r 'OldService' . --include="*.php" --exclude-dir=vendor，重点盯config/、routes/、tests/和注解里的字符串 - 检查所有
use语句是否更新：如果移动文件后use没变，大概率是目标目录没设为 Sources Root，或原namespace声明不在文件首行（比如前面有declare(strict_types=1);但没空行）
Replace in Path 是补救而非替代
当批量改完类名发现大量字符串引用没更新，别再用 Shift+F6，直接上 Ctrl+Shift+R（Windows/Linux）或 Cmd+Shift+R（macOS）：
- 搜索框填
OldService，勾选Match case和Words only，避免匹配到OldServiceProvider这类子串 - 范围选
Directory，但务必取消勾选vendor/目录 —— 第三方库代码不能动 - 替换前一定点
Find预览全部匹配项，尤其注意模板文件（.blade.php）、配置数组（'class' => 'OldService'）和反射调用（class_exists('OldService')）
最易被忽略的是：重命名后 IDE 显示绿色无报错，但请求一发就 Class not found，往往卡在 composer dump-autoload 没跑，或者 grep 漏了注解里的字符串类名——别信预览列表，它只显示静态引用。
