安全重命名必须用Shift+F6，提取方法前光标需落在连续语句块首行；动态调用、字符串类名、第三方库未配置等导致索引失效；Extract Method要求逻辑完整、无语法断裂；重命名类后须手动同步PSR-4路径与字符串引用。
安全重命名必须用 Shift+F6，提取方法前光标得落在连续语句块首行——这两个动作一旦做错，90% 的重构失败和后续报错都源于此。
为什么 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，能跳转到定义才说明上下文完整
Extract Method 菜单灰掉或提示 Cannot extract method
PhpStorm 不是靠你选中的文本判断，而是从光标所在行开始往下扫描逻辑边界。常见卡点：
- 光标不在**连续语句块首行**：比如你拖选了
if块内部几行，但光标实际在else分支里，它就拒绝识别 - 下方有断裂点：未闭合的
{、提前的return、break、throw，或跨if/else分支的不完整控制流 - 引用了拼错的变量：比如原代码写的是
$userr->getName()（多打了个 r），PhpStorm 会把它当新参数加进签名，生成function xxx($userr)，调用时直接报错 - 含
global $cache或引用传递&$arr，提取后默认不带声明，需手动补global或&
提取后方法没类型提示，PHPStan 和 IDE 补全全失效
PhpStorm 默认生成的是 function process($data)，不带任何类型信息——哪怕你原代码写了 /** @var array $data */ 或 array $data，它也不会迁移过去。
立即学习“PHP免费学习笔记（深入）”；
- 后果很实际：PHPStan 报
Parameter #1 $data of function process expects array, mixed given；IDE 进入方法后推不出$data['id']是否存在 - 返回值不确定时（比如
if返回$a、else返回$b），生成的方法可能标成void，或干脆没return声明 - 实操建议：提完立刻改签名，例如
function process(array $data): array；若返回类型复杂，补上@return User[]|null注解
重命名类名后 Composer autoloader 失效
这是最常被忽略的一环：类名改了，但 PSR-4 映射路径和字符串类名不会自动同步。
-
composer.json里的 PSR-4 映射（如"App\": "app/"）不变，但旧类app/Services/OldService.php已重命名为NewService.php，必须手动运行composer dump-autoload - 所有
app('OldService')、resolve('OldService')、config(['service.class' => 'OldService'])这类字符串注册点，PhpStorm 完全不追踪，得人工grep - 类注解里的
@see OldService、@deprecated OldService::doSomething()不会更新，也得手动替换 - 如果类被 trait
use且子类重写了同名方法，Shift+F6 会弹窗问“是否更新子类覆盖”，别直接点 OK——先确认子类逻辑是否适配新签名
