Shift+F6是PHP变量安全重命名的唯一方式，基于语义分析仅修改当前作用域内被识别为变量的引用，需光标置于变量名上；Ctrl+R等文本替换危险且不精准。
用 Shift+F6 重命名变量，不是 Ctrl+R
直接 Ctrl+R 替换变量名是危险操作：它会无差别匹配所有文本，包括注释、字符串、JSON 字段、SQL 片段里的同名内容，甚至把 $user_id 错改成 $pdo_id（因为 user 被替换了）。真正安全的方式只有 Shift+F6 —— 它基于 PHP 语义分析，只改当前作用域内“被识别为变量”的引用。
关键点：
- 光标必须停在你要重命名的变量符号上（比如
$data的data部分），不是选中它 - 如果变量没声明类型、也没初始化（如
$result出现在if块里但前面没$result = null;），PhpStorm 可能识别不出它是局部变量，导致重构失败或漏改 - 重构后自动更新调用点、
isset()、unset()、empty()等所有语义相关位置，但不会碰$_POST['data']或"data"这类字符串
动态调用和字符串里的变量名永远不被重构覆盖
Shift+F6 对运行时决定的名称完全无效。这些地方必须人工核对，否则上线就出错：
-
$_GET['username']改成$_GET['user_id']后，模板里<?php echo $username; ?>不会变——因为一个是数组键（字符串），一个是变量名（符号） -
call_user_func([$obj, $method])中的$method是运行时变量，重命名方法名后这里不会更新 -
class_exists('OldService')、app('OldService')、路由注解@Get("/old-list")全部漏掉，得用Ctrl+Shift+F全局搜OldService
想批量把所有 $db 换成 $pdo？别依赖 Shift+F6
Shift+F6 是按作用域逐个确认的，对跨文件、无类型声明、上下文模糊的 $db 极易漏改。这时该切到文本层：
立即学习“PHP免费学习笔记（深入）”；
- 用
Ctrl+Shift+R（Replace in Path），搜索\$db\b（正则 + 单词边界），替换为\$pdo - 范围选
Directory，勾选Match case和Words only，避免把$dbConnection错改成$pdoConnection - 预览全部匹配项，特别检查
vendor/是否被误触；硬编码路径（如require 'config/db.php'）和 JSON 数据字段也靠这个补全
重命名后，类路径和 autoloader 不会自动同步
改了类名或移动了类文件，composer.json 里的 PSR-4 映射不会变，autoload 缓存也不会刷新。结果就是 Class not found：
- 类名从
UserService改成UserProvider，必须手动运行composer dump-autoload - 如果还改了文件路径（如从
app/Services/UserService.php移到app/Providers/UserProvider.php），PSR-4 映射也要同步调整 - 别信 IDE 弹窗里那个 “Update PSR-4 mapping” 小勾选项——它只在你启用 Composer 集成且配置正确时才生效，多数项目里它根本没反应
最常被忽略的是：重构只解决“代码怎么写”，不解决“运行时怎么找”。字符串、反射、拼接路径、第三方配置，全得靠人眼扫一遍。
