Shift+F6是PhpStorm唯一安全的批量重命名方式，它基于语义分析精准更新引用，跳过字符串、注释及无关同名符号；动态调用、硬编码键名等需人工核对或正则替换，类路径变更后须手动执行composer dump-autoload。
不能用多光标或 Ctrl+R 直接替换变量名——那不是重命名，是埋雷。 PhpStorm 唯一安全的批量变量重命名方式是 Shift+F6，它基于语义分析精准更新引用，跳过字符串、注释和无关同名符号。
为什么 Shift+F6 是唯一推荐方式
因为变量作用域、类型推断、继承链、调用点这些信息，只有语义重构能识别。手动文本替换会误改 $_POST['username'] 里的 username，或把注释里“建议用 $user_id”也替掉。
-
Shift+F6按光标位置锁定范围：光标停在函数参数$user_name上，就只改该函数内所有对该参数的引用，不影响其他函数里同名的局部变量 - 自动同步更新：
$this->data重命名后，isset($this->data)、$this->data = ...全部跟着变，但$_GET['data']和字符串"data"完全不动 - 类型提示和 PHPDoc 注解也会更新，比如
@param User $user中的$user名字会同步改
Shift+F6 失效的常见场景与补救
静态分析覆盖不到的地方，Shift+F6 不会动，必须人工介入：
- 动态调用：
call_user_func([$obj, $method])中的$method是运行时字符串，重命名方法名后这里不会更新 - 硬编码键名：
$_GET['username']改成$_GET['user_id']后，模板中<?php echo $username ?>不会变——$username是变量，'username'是数组键，语义不同 - 反射和类名字符串：
class_exists('AppServicesOldName')、app('AppServicesOldName')、路由注解@Get("/getUserList")全部漏掉 - 解决办法：用
Ctrl+Shift+F全局搜原名，逐个确认是否需手动改；关键位置加注释标记，比如// @rename-me: $db → $pdo
想把项目里所有 $db 统一换成 $pdo？别依赖 Shift+F6
它不支持跨作用域“一键全换”，尤其当 $db 缺少类型声明、上下文模糊时，容易漏或误判。这时候该切到文本层：
立即学习“PHP免费学习笔记（深入）”；
- 用
Ctrl+Shift+R（Replace in Path），搜索\$db\b（正则开启，\b确保只匹配完整单词） - 范围选
Directory，勾选Match case和Words only - 预览全部匹配项——特别注意
vendor/是否被误触，以及$dbConnection这类复合名是否被错误命中 - 字符串里硬编码的路径（如
require 'config/db.php'）或 JSON 字段名，也得靠这个方式补全
重命名后最易被忽略的一件事
类名或文件名改了，composer.json 里 PSR-4 映射的路径不会自动更新；类文件移动后，必须手动运行 composer dump-autoload，否则直接报 Class not found。这不是 PhpStorm 的问题，而是 Composer 的机制决定的——IDE 不接管 autoloader 生成逻辑。
