Shift+F6是单目标语义重构而非批量重命名工具，仅安全更新光标所在符号的全部语义引用；批量改名需组合使用Ctrl+Shift+R文本替换与手工验证autoload及路径。
不能用快捷键“批量”重命名多个变量或文件名——Shift+F6 是单目标语义重构，不是批量替换工具。 试图用它一次改遍项目里所有 $db 或所有 User.php，要么失败，要么漏改，还可能误伤字符串和注释。
Shift+F6 只作用于光标所在符号，且严格按作用域生效
它不是搜索替换，而是基于 AST 的安全重构。光标停在哪，就重构哪个符号的全部语义引用：
- 光标放在函数参数
$user_id上按Shift+F6，只改该函数体内所有对该参数的读写，不影响其他函数里同名的$user_id - 光标停在类属性
$this->config的config上，会同步更新$this->config = ...、isset($this->config)，但不会碰$_ENV['config']或字符串"config" - 若变量未声明（如
if (...) { $result = true; }中的$result），PhpStorm 可能无法识别其作用域——先补一行$result = null;再触发Shift+F6
动态调用、反射、硬编码键名完全不被 Shift+F6 覆盖
这些地方靠静态分析根本抓不到，必须人工核对：
-
$_GET['username']改成$_GET['user_id']后，模板中<?php echo $username; ?>不会变——因为一个是数组键，一个是变量名，语义不同 -
call_user_func([$obj, $method])中的$method是运行时字符串，重命名方法后这里不会更新 -
class_exists('AppServicesOldName')、app('AppServicesOldName')、路由注解@Get("/getUserList")全部漏掉，得用Ctrl+Shift+F全局搜原名
想改多个同名变量？别信 “Rename all occurrences”
那个选项看似批量，实则危险：它仍受限于上下文推断能力，对无类型声明、无显式赋值的变量常直接跳过。
立即学习“PHP免费学习笔记（深入）”；
- 真要统一把项目里所有
$db换成$pdo，该切到文本层：Ctrl+Shift+R（Replace in Path） - 搜索填
\$db\b（\b确保单词边界，避免误改$dbConnection） - 范围选
Directory，勾选Match case和Words only，务必预览全部匹配项 - 特别注意
vendor/目录是否被包含——误触第三方库会导致不可逆破坏
文件重命名后，路径引用和 autoload 映射不会自动同步
这是最容易被忽略的致命环节：
- 用
Shift+F6重命名User.php→Member.php，它会更新use App\Models\User;和new User()，但不会动composer.json里的 PSR-4 映射 - 如果类文件移动了路径（比如从
app/Models/移到app/Entities/），必须手动执行composer dump-autoload，否则运行时报Class not found - 硬编码路径如
require 'config/db.php'或 JSON 字段名，也得靠Ctrl+Shift+R单独补全
真正安全的“批量”动作，其实是分层组合：先用 Shift+F6 处理可推断的语义符号，再用 Ctrl+Shift+R 补动态和字符串场景，最后手工验证 autoload 和跨目录路径。任何想一步到位的尝试，都会在某个角落留下运行时错误。
