PhpStorm 中 Shift+F6 仅支持单符号/单文件安全重构，多文件重命名仅为文本操作；动态调用、字符串类名、数组键、Composer PSR-4 映射及硬编码路径均需手动处理。
PhpStorm 里没有“批量重命名重构”这回事——所谓批量，要么是单文件语义重构（安全），要么是多文件文本替换（高风险），二者不能混用。
Shift+F6 重命名只对单个符号或单个文件生效
光标停在哪，就重构哪个作用域：变量、方法、类、文件名，都严格绑定光标位置。它不会因为你选中了十个文件，就自动更新这十个文件里所有同名变量。
- 把光标放在
$user_id上按Shift+F6，只会改当前函数/方法内对该变量的所有引用，不影响其他函数里的同名局部变量 - 放在类名
User上，会同步更新new User()、use AppModelsUser、class Admin extends User，但不会动$_POST['user']或 JSON 字段"user_name" - 放在文件
User.php上右键 →Refactor → Rename，会扫描全项目所有require、include、use、硬编码路径字符串（需勾选Search in comments and strings）
多选文件重命名 = 改名不更新引用，不是重构
在 Project 视图中 Ctrl+多选一堆 .php 文件，再右键 → Rename，IDE 只会改文件系统名字，完全不扫描任何代码引用。这不是重构，是文件管理操作。
- 如果某处写了
require 'UserModel.php';，你把它重命名为User.php，这行代码不会变，运行时直接报failed to open stream - 这种操作仅适用于纯整理场景：比如统一命名风格，且你确认这些文件没被硬编码路径引用过
- 若已执行多选重命名，补救唯一方式是
Ctrl+Shift+R（Replace in Path），搜索旧文件名字符串，替换成新文件名字符串，并务必勾选Words only和Match case
动态调用和字符串类名永远逃过 Shift+F6
PhpStorm 的静态分析无法追踪运行时行为，所有靠字符串拼接、反射、eval、call_user_func 等方式触发的调用，都不会出现在重构预览列表里。
立即学习“PHP免费学习笔记（深入）”；
-
class_exists('OldService')、app('OldService')、new $className()中的OldService不会被重命名影响 -
$_GET['old_param']改成$_GET['new_param']后，模板里<?php echo $old_param ?>不会变——因为这是变量名，而数组键是字符串，语义分离 - 必须人工执行
Ctrl+Shift+F全局搜索原名，重点检查配置、路由注解（如@Get("/old-api")）、JSON Schema、SQL 查询字符串
重命名后 Composer autoloader 失效是高频漏点
类名或文件路径变了，但 composer.json 里的 PSR-4 映射不会自动更新，也不会自动执行 dump-autoload。
- 比如把
app/Services/OldService.php重命名为app/Services/NewService.php，且类名也从OldService改为NewService，但composer.json仍写着"App\Services\": "app/Services/"—— 这没问题；但如果目录结构也变了（比如移进app/Domain/），PSR-4 路径就必须手动同步 - 哪怕路径没变，只要文件移动过或类名改过，就得手动运行
composer dump-autoload，否则Class not found报错必现 - 第三方包里的类名引用（如
use IlluminateSupportStr;）不受影响，但你自己代码里写死的字符串类名（如'IlluminateSupportStr'）得自己搜
