Shift+F6是PhpStorm唯一安全的语义化重命名方式，基于作用域精准修改变量/方法引用，自动排除注释、字符串、JSON键、SQL字段等非代码逻辑位置，动态调用和硬编码类名需手动处理。
Shift+F6 是唯一安全的变量/方法重命名入口
直接 Ctrl+R 或多光标改名不是重命名，是文本污染。PhpStorm 的 Shift+F6 基于语义分析，只改当前符号在作用域内真正相关的引用，自动跳过注释、字符串、无关同名变量、JSON 键名、SQL 字段等。光标停在哪，就重构哪——$user 在函数参数上按 Shift+F6，只影响该函数体内所有对该参数的读写；停在类属性 $this->data 的 data 上，会同步更新 $this->data =、isset($this->data)，但不会碰 $_POST['data'] 或字符串里的 "data"。
动态调用和字符串类名必须人工核对
静态分析无法覆盖运行时行为，这些地方 Shift+F6 完全不处理，漏掉就报错：
-
call_user_func([$obj, $method])中的$method是字符串变量，方法名改了，这里不会变 -
class_exists('OldService')、app('OldService')、new 'OldService'()全部静默跳过 - 路由注解如
@Get("/old-list")、模板中硬编码的<?php echo $oldVar ?>也不在重构范围内 - 必须用
Ctrl+Shift+F全局搜索原名，逐条确认上下文是否应同步修改
批量改多个同名变量？别依赖 Rename All Occurrences
想把全项目里所有 $db 换成 $pdo，Shift+F6 不是首选——它会按作用域逐个弹窗确认，且对无类型声明、上下文模糊的 $db（比如没初始化就直接用）可能根本识别不出，导致漏改。
更可靠的做法是切到文本层：
立即学习“PHP免费学习笔记（深入）”；
- 用
Ctrl+Shift+R打开 Replace in Path - 搜索填
\$db\b（\b确保只匹配完整单词，避免把$dbConnection错改成$pdoConnection） - 替换为
$pdo，勾选Match case和Words only - 范围选目标目录（如
app/），务必排除vendor/，并先点Find预览所有匹配项 - 特别注意字符串里的路径（如
require 'config/db.php'）、JSON 数据字段、SQL 查询中的WHERE db_id = ?
重命名后最容易被忽略的三件事
改完变量或方法名，不代表万事大吉：
- 类名变更后，
composer.json里 PSR-4 映射的路径不会自动更新，必须手动执行composer dump-autoload，否则 Class not found - 硬编码的路径字符串（如
include 'old_helper.php'）或配置文件里的类名（如'class' => 'OldHelper'）不会被Shift+F6触及，得靠Ctrl+Shift+R补全 - 如果方法签名变了（比如加了新参数、改了返回类型），但调用点没同步更新，PHPStan 或 PHP 8.1+ 的严格模式会立刻报错，这类问题往往藏得深，得靠静态分析工具兜底
