shift+f6是phpstorm中唯一安全批量更新类/方法引用的方式，它基于语义分析逐个重构，需将光标置于目标符号上触发；全局文本替换（如ctrl+r）易误改非引用内容，导致运行错误。
Shift+F6 是唯一能安全批量更新类/方法引用的方式
PhpStorm 不支持“选中 10 个类名 → 一键全改成新名字”这种操作。所谓“批量”，实际是逐个符号触发语义重构，由 IDE 自动识别并更新所有相关引用——这才是安全的根源。你光标停在哪，就改哪；不是你选中了什么，而是它“理解”了什么。
常见错误现象：用 Ctrl+R 全局替换 User 为 Member，结果把 $user_id、username、注释里的 “User model” 全干掉了，运行直接报错。
- 必须把光标放在类名（如
User）、方法名（如findByName）或属性名（如$data）上，再按Shift+F6 - 勾选
Search in comments and strings才能捕获硬编码路径或 JSON 字段名（如'class' => 'User'） - 不勾选
Search for text occurrences时，require 'User.php'这类字符串不会被改——这是故意设计，避免误触 - 如果预览窗口里没列出某个调用点（比如
app('User')），说明 PhpStorm 没把它识别为该类的语义引用，得人工补
类重命名后，PSR-4 路径和字符串类名不会自动同步
改完 User 类名，composer.json 里 "App\": "app/" 映射不变，但文件路径 app/User.php 已变成 app/Member.php，Composer 就找不到类了——这不是 Bug，是设计边界。
- 手动运行
composer dump-autoload是必须步骤，否则Class 'App\Member' not found立刻出现 -
new 'User'()、class_exists('User')、路由注解@Route("user")全部漏掉，必须用Ctrl+Shift+F搜'User'或"User"补全 - 如果类在多个命名空间下同名（如
App\Models\User和App\Contracts\User），Shift+F6会只改当前光标所在那个，不会连带处理另一个
方法重命名要防动态调用和反射漏网
静态分析天然无法覆盖运行时行为，call_user_func([$obj, $method])、$obj->$methodName()、__call() 里的方法名都不会出现在 Shift+F6 预览列表里。
- 先用
grep -r '\$method\|call_user_func\|__call' . --include="*.php"扫描项目，人工核对所有可能拼接方法名的地方 - 检查模板文件（.blade.php、.twig）里是否用了
{{ $user->getName() }}—— 如果getName改成了getFullName，模板里不会自动变 - 测试代码里类似
$this->mock(User::class)->shouldReceive('getName')的 Mock 声明也要同步改，否则测试直接 fail
想一次改多个同名变量？别信 Rename all occurrences
想把全项目所有 $db 都换成 $pdo，Shift+F6 不是正解。它会按作用域一个个弹窗确认，且跳过没类型声明、上下文模糊的变量（比如函数参数没写 PDO $db），极易漏。
- 切到文本层：用
Ctrl+Shift+R（Replace in Path），搜索\$db\b（\b确保单词边界），替换为\$pdo - 务必预览全部匹配项，特别注意
vendor/目录是否被误触——勾选Exclude libraries或手动排除 - 字符串里硬编码的键名（如
'db_host' => 'localhost'）不会被匹配，得单独搜db_补全 - 如果
$db在部分文件里是全局变量（global $db），替换后记得补上global $pdo，否则 Notice 报出来
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
