Shift+F6 安全重命名是唯一能同步更新所有相关引用的方式；批量改名不可行，因PhpStorm依赖上下文语义分析，跨作用域无法统一推断变量语义，且字符串、动态调用等不参与重构。
用 Shift+F6 逐个文件、逐个符号安全重命名，才是唯一能同步更新所有相关引用的方式。所谓“一键批量改全项目所有同名变量/类/文件”，不存在，强行操作等于自埋引用断裂雷。
为什么不能直接批量重命名所有 $db 变量？
PhpStorm 的语义分析依赖上下文：光标停在哪，就重构哪一作用域。它不会、也不能跨函数、跨文件统一推断一个变量名是否“该被一起改”。比如：
-
$db在UserService构造函数里是 PDO 实例，在ReportController里可能是数组键名或字符串字面量 —— 两者语义完全不同 - 没类型声明的
$db（如function foo($db) { ... }），PhpStorm 推断不出它是数据库连接，可能跳过所有调用点 -
$_POST['db']、"SELECT * FROM $table"、class_exists('DbHelper')全部不参与Shift+F6重构，因为它们不是 PHP 符号引用
Shift+F6 重命名时必须确认的三个选项
弹出对话框后，这三个勾选直接影响重构范围和安全性：
-
Search in comments and strings：只在你明确知道字符串里硬编码了路径（如
require 'lib/db.php'）时才勾选；否则会误改日志、SQL 注释、JSON 示例等 -
Search for text occurrences：用于匹配非结构化文本（如配置文件、Markdown 文档里的类名），但会混入无关结果，建议先点
Find预览再决定是否启用 -
Rename usages in non-PHP files：模板（.blade.php/.twig）、Vue 单文件组件、甚至 .env 文件中出现的类名/变量名——开启后需逐条检查，尤其注意双大括号插值
{{ $user }}和 JS 字符串拼接
动态调用和字符串类名必须人工补漏
以下写法永远逃过 Shift+F6 扫描，不手动处理，上线必报错：
立即学习“PHP免费学习笔记（深入）”；
-
call_user_func([$obj, $method])中的$method是运行时变量，改方法名后这里不会变 -
new $className()、class_exists($name)、app($service)—— 字符串内容不参与语义索引 - 路由注解如
@Get("/users")、事件监听器名'AppEventsUserCreated'、队列任务类名硬编码在 JSON 消息体里 - 补救方式统一：用
Ctrl+Shift+R（Windows/Linux）或Cmd+Shift+R（macOS），填正则['"]App\\Models\\User['"]，范围限定在*.{php,phpstorm,blade.php,yaml}
类名改完，别忘了三处硬编码残留
类重命名后，Shift+F6 能更新 use 和 new User()，但以下位置它从不碰：
-
composer.json里的 PSR-4 映射路径（如"App\": "app/"不会自动变成"App\Domain\": "app/Domain/"） - 所有
require/include硬编码路径（如require __DIR__.'/helpers/UserHelper.php';） - 测试文件中的
$this->mock(User::class)或 Mockery 声明，如果用了字符串形式Mockery::mock('User')，也得手动搜 - 改完必须立即执行
composer dump-autoload，否则Class not found报错立刻出现
最易被忽略的是作用域边界：Shift+F6 重命名一个类，它只更新当前项目索引到的引用；如果类被 vendor 包引用，或项目未正确配置 PHP 解释器和 autoload，那些地方根本不会出现在预览列表里——得靠 grep -r 或 phpstan 扫描补全。
