唯一安全的方式是用Shift+F6，因多光标和Ctrl+R仅为纯文本替换，会误改字符串、注释及漏掉类型声明、PHPDoc等语义关联内容，而Shift+F6能智能识别作用域并同步更新引用。
唯一安全的方式是用 Shift+F6，不是多光标、不是 Ctrl+R 文本替换，也不是批量选中后右键 Rename。
为什么不能用多光标或 Ctrl+R 替换变量名
多光标（Alt+J）和 Ctrl+R 是纯文本操作，完全不识别 PHP 语义：
– 会误改字符串里的同名内容，比如 $user 在 '{"user":"admin"}' 里也被替掉
– 注释中的 // $user is deprecated 也会被改，但实际不该动
– 漏掉类型声明（function handle(User $user)）、PHPDoc（@param User $user）、继承类里的同名属性等
– 更危险的是：它不会更新调用点，比如 $user->getName() 里的 $user 变量名改了，但方法签名没同步，IDE 补全立刻失效
Shift+F6 重命名的正确姿势
光标位置决定重构范围，不是你“选中了什么”：
– 把光标停在函数参数 $user_name 上按 Shift+F6，只改该函数内所有对该参数的引用，不影响其他函数里同名的局部变量
– 停在类属性 $this->data 的 data 上，会同步更新 $this->data = ...、isset($this->data)，但跳过 $_POST['data'] 或字符串里的 "data"
– 如果变量没显式声明（比如 if (...) { $result = ...; }），PhpStorm 可能推断不出作用域，先补一行 $result = null; 再重命名
操作时注意勾选：
– Search in comments and strings：仅当你确认字符串/注释里真有路径或键名需要同步（如硬编码 JSON 字段）
– Search for text occurrences：用于匹配非结构化文本，比如日志模板里的 "User: {$user}"（需人工核对）
– 不勾选这两项是默认安全行为，90% 场景下保持默认即可
立即学习“PHP免费学习笔记（深入）”；
哪些地方 Shift+F6 完全不管，必须人工处理
静态分析无法覆盖运行时行为：
– 动态调用：call_user_func([$obj, $method]) 中的 $method 是字符串变量，重命名方法名后这里不会变
– 字符串类名：class_exists('UserService')、app('UserService')、new $className() 全部漏掉
– 数组键名：$_GET['username'] 改成 $_GET['user_id'] 后，模板里 <?php echo $username ?> 不会变——因为 $username 是变量，'username' 是字符串键，语义不同
– 路由注解：@Get("/users/{id}") 里的路径参数名不属于 PHP 变量范畴
这些必须靠 Ctrl+Shift+F 全局搜原名，逐个确认是否要改，并留意上下文是否属于运行时拼接逻辑
批量改多个同名变量？别信 “Rename all occurrences”
想把全项目里所有 $db 换成 $pdo，Shift+F6 不是解法：
– 它按作用域逐个弹窗确认，容易漏掉无类型声明、无初始化的 $db
– 对于跨文件、跨作用域的全局变量，它甚至可能根本识别不出引用关系
这时该切到文本层：
– 用 Ctrl+Shift+R（Replace in Path）
– 搜索 \$db\b（正则，\b 确保只匹配完整单词）
– 替换为 \$pdo
– 范围选 Directory，勾选 Match case 和 Words only
– 务必先点 Find 预览全部匹配项，重点排查 vendor/ 是否被误触、是否命中 $dbConnection 这类复合名
最易被忽略的一点：Shift+F6 重命名类或接口后，composer.json 里 PSR-4 映射路径不会自动更新，类文件移动或改名后必须手动运行 composer dump-autoload，否则 Class not found 报错直接出现。
