Ctrl+Alt+M提取方法需光标置于语句块首行最左，IDE依静态分析扫描完整结构；变量自动转参但拼写/作用域须正确；类型提示、返回值、引用传递及global等需手动补全；提完须格式化并核查逻辑边界。
Ctrl+Alt+M 是 PhpStorm 提取方法的快捷键，但它不是“按了就成”，而是依赖光标位置和语句结构是否满足静态分析要求——90% 的失败都卡在这两点上。
光标必须停在语句块第一行最左侧
PhpStorm 的 Extract Method 不认你选中的文本，只从光标所在行开始往下扫描，直到遇到控制流断裂或语法不完整为止。常见失效场景：
- 光标停在
$user->getName()中间的->上、括号里、空格中 → 功能灰掉 - 光标在
if ($x) {这行中间，没包住整个if块 → 弹出Cannot extract method - 跨多行的
try/catch或foreach只选了 body 部分，没包含起始和结束标记 → 扫描中断
正确做法：把光标放在你要提取的第一行开头（比如 $result = $a + $b; 这整行最左边），再按 Ctrl+Alt+M。
被引用变量自动转参数，但拼写和作用域必须干净
IDE 会把代码块中读取的外部变量自动列为参数，但不会校验是否真存在或是否拼错：
立即学习“PHP免费学习笔记（深入）”；
- 原代码写了
$userr->id（多打了个r），提取后生成function xxx($userr)，调用时直接报错 - 用了
&$arr引用传递，提取后签名没带&，行为静默改变 - 上下文有
global $cache，提取后新函数里没加global $cache，运行时报Undefined variable
实操建议：提之前先确保所有变量已正确定义、拼写无误；提完立刻检查生成的参数列表，手动补 &、global 或 static 等修饰符。
类型提示不会自动迁移，必须手动补全
PhpStorm 默认生成的是 function process($data)，没有任何类型信息。后果很实在：
- PHPStan 报
Parameter #1 $data of function process expects array, mixed given - IDE 无法推导
$data['id']是否存在，补全失效 - 后续调用传错类型（比如传了
string）也没警告
原因在于原上下文里的 /** @var array $data */ 或 array $data 参数注解，不会跟着一起迁移到新函数。解决方式很简单：提完立刻改成 function process(array $data): array，复杂返回值用 PHPDoc 补 /** @return User[] */。
返回值不确定时，IDE 很可能标成 void
如果被提取的代码块在不同分支里返回不同变量（比如 if 返回 $a，else 返回 $b），PhpStorm 推不出统一类型，常默认不写 return 或标成 : void：
- 实际逻辑有返回值，但签名是
function xxx(): void→ 类型检查崩了 - 调用处接收不到返回值，IDE 跳转也找不到定义
解决办法：弹出的重构对话框里勾选 Declare return type，手动填具体类型（如 string、array、User|null）；或者提完立刻补上完整签名和 PHPDoc。
真正容易被忽略的是：提取后函数体内的变量名、缩进、空行风格全靠你手动清理，IDE 不会自动格式化——尤其是嵌套深或含模板字符串时，很容易留下难以维护的“半成品”。别急着提交，先按 Ctrl+Alt+L 格式化，再通读一遍逻辑边界是否合理。
