Shift+F6是安全重命名的唯一可靠方式，因它能自动更新所有静态引用；而Ctrl+R仅文本替换，无法识别作用域和语义，易导致Undefined function等错误，尤其对动态调用、字符串类名、配置项及注解无效。
安全重命名必须用 Shift+F6，不能靠 Ctrl+R 文本替换；提取方法前要确认光标在完整语句块内，否则菜单灰掉或报错。
为什么 Shift+F6 重命名后还有 Undefined function 错误
这不是重构失败，而是 PhpStorm 静态分析的天然盲区没被覆盖：
- 动态调用如
call_user_func('old_name')、$obj->$method()、eval()中的函数名不会被识别，必须手动grep -r "old_name"检查 - 字符串类名（如
new 'OldClass'()、class_exists('OldClass')）同样跳过，且不会出现在预览列表里 - 如果
old_name是第三方库函数但项目没正确配置 PHP 解释器或未引入 autoload，PhpStorm 根本无法索引其定义，导致重命名只改当前文件 - 检查是否真能跳转：把光标停在函数名上按
Ctrl+Click，能跳到定义才说明上下文完整
提取方法时菜单灰掉或提示 Cannot extract method
PhpStorm 不是“选中就提”，它依赖代码结构合法性来推断作用域边界：
- 光标必须落在**连续、无中断的语句序列首行**，比如不能跨
if和else分支，也不能包含未闭合的{或提前return - 被选中的代码不能引用外部未声明变量（如拼错的
$user_idd），否则参数推导失败 - 含副作用的语句（如
$cache->set($key, $val)、array_pop($list)）可被提取，但重构后执行时机改变——原位置执行一次，新方法里可能被多次调用 - 提取后生成的参数默认无类型提示，
function process($data)应手动补成function process(array $data): void，否则 PHPStan 或 IDE 类型检查会报mixed
重命名类名后 Composer autoloader 失效怎么办
类名改了，但 PSR-4 映射路径和字符串类名不会自动同步，这是最常被忽略的环节：
立即学习“PHP免费学习笔记（深入）”；
-
composer.json里的 PSR-4 映射（如"App\": "app/"）不变，但旧类app/Services/OldService.php已重命名为NewService.php，必须手动运行composer dump-autoload - 所有
app('OldService')、resolve('OldService')、config(['service.class' => 'OldService'])这类字符串形式注册点，PhpStorm 完全不追踪 - 类注解里的
@see OldService、@deprecated OldService::doSomething()不会更新，得人工 grep 替换 - 如果类被 trait use 且子类重写了同名方法，Shift+F6 会弹窗问“是否更新子类覆盖”，别直接点 OK，先看子类逻辑是否还适配新签名
重构不是魔法，它只保证静态可分析的部分安全。动态调用、字符串类名、配置项、注解、第三方集成点——这些都得你亲手过一遍。越大的重命名，越要先 git add -p 拆分提交，方便出问题时精准回退。
