Shift+F6是安全重命名变量的正确方式，因它只改当前作用域内可静态推断的引用，避免硬替换误伤注释、字符串、第三方库等上下文无关位置。
光标停在变量名上按 Shift+F6，不是选中它再按——选中会触发文本替换，不是重构。
为什么直接改名或 Ctrl+R 会出问题
硬替换不区分上下文：$user 出现在注释里、字符串里、其他类的私有属性里，甚至第三方库文件中，都会被一并替换。比如把 $_POST['username'] 改成 $_POST['user_id'] 后，模板中仍用 $username 渲染，运行时就报未定义变量。
- PhpStorm 的
Rename重构只改当前作用域内可静态推断的引用：函数参数、局部变量、类属性、方法返回值绑定等 - 动态引用如
$$var、call_user_func([$obj, $method])、class_exists('OldName')不会被识别，必须手动 grep - 外部数据键名（如
$_GET['name']）和模板变量名（如 Blade 中的{{ $name }}）不会同步，得靠人眼核对
重命名局部变量时如何锁定作用域
把光标放在目标变量名上（不要选中），按 Shift+F6，弹出对话框顶部会明确显示作用域范围，例如：Rename local variable $data in function processOrder()。
- 别点「Rename all occurrences」——除非你真要全局统一（比如改一个常量名）
- 如果变量定义在
if块里且没显式声明（如if (...) { $data = ...; }），PhpStorm 可能无法推断为局部变量；先加一行$data = null;再重命名，帮它识别作用域 - 匿名函数内的变量重命名，只影响该闭包内部，不影响外部同名变量
类属性/方法重命名后哪些地方不会自动更新
重构能改 use 语句、new ClassName()、static::method() 和继承链调用，但以下三类必须人工介入：
立即学习“PHP免费学习笔记（深入）”；
-
app('App\Services\OldName')、resolve('OldName')这类字符串形式的容器解析，不在静态分析范围内 - Laravel 路由注解（
@Get("/old-method")）、前端 AJAX 请求路径、API 文档中的方法名，全靠Ctrl+Shift+F全局搜原名 -
composer.json中 PSR-4 映射路径不会变——类文件从app/Services/OldName.php移到app/Services/NewName.php后，必须手动运行composer dump-autoload
最易被忽略的是：重命名后 IDE 显示无错误，但运行时报 Class not found 或 Method not found，往往是因为字符串调用或路由配置漏了——别信“重构完成”的提示框，一定要进 vendor/ 外的业务目录跑一次 grep -r 'OldName' . --include="*.php" 确认。
