唯一安全的批量重命名方式是Shift+F6逐个符号重构，因其基于AST精准作用域更新；跨作用域弱类型变量（如$db）须用Ctrl+Shift+R正则替换，并人工校验类型提示、PSR-4映射及调用方兼容性。
唯一安全的批量重命名方法名和变量名的方式，是用 Shift+F6 逐个符号重构，不是批量，而是“精准作用域内批量更新”。想靠一次操作改全项目所有 $db 或 getUser()，必然漏、必然错。
为什么 Shift+F6 不能“批量选中多个函数一起重命名”
PhpStorm 的 Shift+F6 不是文本替换工具，它基于 AST 做语义识别：光标停在哪，就锁定那个符号的声明位置和所有**可静态推断的引用点**。你多选十几个同名方法再按 Shift+F6，IDE 会拒绝操作或只处理第一个——因为它无法确定你到底想改哪个作用域下的哪个符号。
- 光标停在
public function save() { ... }的save上 → 重命名只影响该类及其子类中对该方法的所有调用（含$this->save()、parent::save()） - 光标停在
call_user_func([$obj, $method])的$method上 →Shift+F6对它完全无效，因为运行时值不可知 - 你在两个不同类里都写了
private function getData()，光标分别停在各自函数名上，就得按两次Shift+F6，不能合并
Shift+F6 重命名后哪些地方一定不会被更新
这些地方 PhpStorm 静态分析天然无能为力，必须人工介入：
-
class_exists('OldService')、app('OldService')、resolve('OldService')中的字符串类名 -
$_POST['user_name']、$config['cache_ttl']这类数组键名 —— 和变量名$user_name是两回事，语义隔离 -
call_user_func(['User', 'oldMethod'])、$obj->$methodName()中的字符串方法名 - 注释里写的示例代码：
// $user->oldMethod() → 应该改成 newMethod() - 路由注解如
@Get("/api/v1/old-list")、前端 JS 模板中的{{ user.oldName }}
这些全部得靠 Ctrl+Shift+F 全局搜原名，再用 Ctrl+Shift+R 手动替换，并勾选 Match case 和 Words only 防误替。
立即学习“PHP免费学习笔记（深入）”；
想改全项目所有 $db 变量为 $pdo？别用 Shift+F6，用 Ctrl+Shift+R + 正则
当目标是跨作用域、弱类型、无声明上下文的通用变量名（比如没写 /** @var \PDO $db */），Shift+F6 会大量漏掉，尤其在函数参数、循环变量、临时赋值等场景。这时应切到文本层：
- 打开
Ctrl+Shift+R（Replace in Path） - 搜索框填：
\$db\b（\b确保匹配完整单词，避免把$dbConnection错改成$pdoConnection） - 替换为：
$pdo - 范围选整个
src/目录，**务必取消勾选vendor/**（否则可能破坏第三方包） - 先点
Find预览所有命中项，重点检查是否误中了'$db'字符串、SQL 拼接、JSON 模板
注意：这种替换不更新 PHPDoc 类型提示、不修正 use 语句、不补 global $db 声明 —— 它只是文本动作，后续需人工校验逻辑连贯性。
重命名后最容易被忽略的三件事
改完名字只是第一步，以下三点不做，轻则报错，重则静默逻辑错误：
- 类名或接口名改了，但
composer.json里 PSR-4 映射路径没同步 → 必须手动执行composer dump-autoload，否则Class not found - 方法签名变了（比如加了新参数），但调用方没同步更新 →
Ctrl+Shift+F搜旧方法名，看还有哪些地方在用老调用方式 - 变量名改了，但 PHPStan / Psalm 的类型推断失效了 → 原来有
/** @var User $user */，现在变成$user2，注解没跟着走，得手动补或用 PHPDoc 重构插件
重构不是终点，是验证起点。每次 Shift+F6 后，顺手 Ctrl+Click 点一下新名字，确认能跳转到定义；再 Ctrl+Shift+F 搜一遍旧名，看是否真清干净了。
