多选文件右键Refactor→Rename仅改名不更新引用，因PhpStorm设计上禁止为多个PHP文件并行执行跨文件引用分析；补救须用Ctrl+Shift+R全局替换硬编码路径，并人工核对动态调用与配置字符串。
批量重命名文件后引用没更新，不是 PhpStorm 失效，而是你用了不触发引用更新的操作方式——多选文件右键 Refactor → Rename 仅改名，从不扫描或修改任何代码中的路径、use、require 或类名字符串。
为什么多选重命名不更新引用
PhpStorm 的重构系统设计上就拒绝为多个 PHP 文件同时执行跨文件引用分析。它需要逐个确认符号作用域、命名空间合法性、PSR-4 映射关系和调用上下文，这些无法并行安全推导。
- 你在 Project 视图中 Ctrl+多选十几个
.php文件，再右键Refactor → Rename，IDE 实际执行的是「文件系统重命名」，等同于在终端运行mv - 所有
require 'old_name.php';、use AppOldName;、new OldName();都原封不动，运行时直接报Warning: require(): failed to open stream或Class not found - 即使你勾选了
Search in comments and strings，该选项只对当前被选中的单个文件生效，不跨文件扫描
补救：Replace in Path 是唯一可靠手段
必须用 Ctrl+Shift+R（Windows/Linux）或 Cmd+Shift+R（macOS）打开全局文本替换，手动覆盖遗漏的路径字符串。
- 搜索内容填
old_name.php，替换为new_name.php；务必勾选Match case和Words only，避免把config_old_name.php.bak错替成config_new_name.php.bak - Scope 必须设为
Project或自定义范围（如只含app/和config/），不能留在Current File - 点
Find预览全部匹配项——重点检查是否误命中注释、日志、第三方库（vendor/应排除）、或拼接路径：$path = __DIR__ . '/models/' . $name . '.php';这种动态构造的路径不会被匹配，得人工翻逻辑
哪些引用永远逃过 Replace in Path
静态文本替换能覆盖硬编码字符串，但对运行时行为完全无感。以下几类必须人工核对或正则扫全项目：
立即学习“PHP免费学习笔记（深入）”；
- 字符串类名：
class_exists('AppOldName')、app('AppOldName')、resolve('AppOldName') - 数组键名：
$_POST['old_name']改了变量名但模板里仍写<?php echo $old_name ?>，两者语义分离，重构不联动 - 反射与动态调用：
call_user_func([$obj, $method])中的$method是变量值，不是符号名；eval()内容完全不索引 - 路由注解、验证规则、数据库字段映射等配置型字符串，例如
@OA\Property(property="old_name", ...)
下次怎么做才真正安全
想批量改名又保引用，没有“一键宏”，只有分层操作：
- 单文件高频变更：坚持用
Shift+F6逐个重构，确保每个require、use、new、命名空间都被扫描到 - 大量文件需统一后缀（如
.php→.inc）：用 PHP 脚本处理文件系统，再用Replace in Path扫描所有硬编码路径 - 类名/命名空间级变更（如
AppOldService→AppNewService）：先Shift+F6重命名类，再Ctrl+Shift+R全局搜AppOldService补漏，最后别忘composer dump-autoload
最易被跳过的环节是 PSR-4 路径变更后没运行 composer dump-autoload，导致 IDE 索引和 autoloader 完全脱节——这不是界面问题，是底层加载机制断连。
