PhpStorm 的 Shift+F6 是唯一安全的重命名方式，它基于语义分析精准更新相关引用，跳过注释、字符串及无关同名符号，并严格按光标所在符号锁定重构范围；动态调用、反射、硬编码键名等需人工核对或正则替换，类路径变更后须手动执行 composer dump-autoload。
别用多光标或 Ctrl+R 直接替换变量名，那不是重命名，是埋雷。 PhpStorm 的 Shift+F6 重构才是唯一安全路径——它只改语义上真正相关的引用，跳过注释、字符串、无关同名符号，还能同步更新调用点、继承关系和类型提示。
光标位置决定重命名范围
重构作用域由光标停靠位置严格锁定，不是你“选中了什么”，而是“光标落在哪个符号上”：
- 把光标放在函数参数
$user_name上按Shift+F6，只会改这个函数内对该参数的所有引用，不影响其他函数里同名的局部变量 - 放在类属性
$this->data的data上，会同步更新所有对该属性的读写（$this->data = ...、isset($this->data)），但不会碰$_POST['data']或字符串里的"data" - 如果光标停在
if块里未显式声明的$result上，PhpStorm 可能识别不出它是局部变量——先补一行$result = null;再重命名，帮它推断上下文
动态调用和字符串里的名字永远不被重构捕获
PhpStorm 静态分析无法追踪运行时拼接或反射行为，这些地方必须人工核对：
-
$_GET['username']改成$_GET['user_id']后，模板里<?php echo $username ?>不会变——因为$username是 PHP 变量名，而'username'是数组键，两者语义分离 -
call_user_func([$obj, $method])中的$method是字符串变量，Shift+F6重命名方法名后，这里不会更新 -
class_exists('AppServicesOldName')、app('AppServicesOldName')、路由注解@Get("/getUserList")全部漏掉，得用Ctrl+Shift+F全局搜原名
批量改多个同名变量？别信“Rename all occurrences”
想把项目里所有 $db 换成 $pdo，Shift+F6 不是首选——它会逐个作用域确认，且跳过无法推断上下文的地方（比如没类型声明的 $db），反而容易漏。这时候该切到文本层：
立即学习“PHP免费学习笔记（深入）”；
- 用
Ctrl+Shift+R（Replace in Path），填入正则\$db\b（\b确保只匹配完整单词，避免把$dbConnection错改成$pdoConnection） - 范围选
Directory，勾选Match case和Words，预览全部匹配项，特别注意vendor/目录是否被误触 - 字符串里硬编码的路径（如
require 'config/db.php'）或 JSON 数据字段名，也得靠这个方式补全
最易被忽略的一点：重命名后，composer.json 里 PSR-4 映射的路径不会自动更新，类文件移动后必须手动运行 composer dump-autoload，否则 Class not found 报错就来了。
