PhpStorm不支持真正批量重命名文件夹并同步更新所有引用，仅能通过单文件Shift+F6重构（安全但慢）、多选Rename（快但无引用更新）、脚本/终端改后缀或移动（可控但需Replace in Path补漏）三者组合实现。
PhpStorm 本身不支持真正意义上的“批量重命名文件夹 + 同步更新所有引用”。所谓“批量”，在 PhpStorm 中实际是三种能力的拼接：单文件重构（安全但慢）、多选改名（快但无引用更新）、脚本/终端辅助（可控但需手动补漏）。指望一个操作全搞定，必然踩坑。
Refactor → Rename 只对单个文件生效，多选后 Rename 不更新任何引用
你在 Project 视图中 Ctrl+多选一堆 UserController.php、PostController.php，右键 → Refactor → Rename，输入 Admin 前缀，它确实会把它们改成 AdminUserController.php 等——但仅此而已。
- 所有
require 'UserController.php'、use App\Http\Controllers\UserController;全部保留原样，运行时直接报错 - 如果这些文件被
composer.json的 PSR-4 映射覆盖，类自动加载也会失败 - 该操作本质等同于系统级重命名，IDE 不做语义分析，也不扫描代码
- 适用场景仅限：你确认这些文件在项目中完全未被硬编码引用，纯属整理磁盘结构
想改名又更新引用？必须一个一个用 Shift+F6
这是唯一能同时修改文件名 + 同步更新 use、new、require、命名空间映射（若启用）的方式。光标位置决定作用域，不是“选中多少”，而是“停在哪”。
- 把光标放在
UserController.php文件名上（Project 视图），按Shift+F6，输入新名，勾选Search in comments and strings（捕获硬编码路径） - 点击
Preview，确认列表里包含所有use、require、new UserController()等调用点 - 若文件内有
class UserController，且命名空间与文件路径一致，重命名后 IDE 通常会同步更新namespace和use语句 - 但
app('UserController')、class_exists('App\Http\Controllers\UserController')这类字符串不会被识别，得靠Ctrl+Shift+R补
批量改后缀或归集到新目录？别在 IDE 里硬刚，用脚本或终端
想把 config.old.php 全改成 config.php，或把零散的 *Model.php 移进 app/Models/ 目录——PhpStorm 的 GUI 操作既慢又不可靠。
立即学习“PHP免费学习笔记（深入）”；
- 后缀批量替换：用 PHP 脚本，
glob('*.old.php')+pathinfo($file, PATHINFO_FILENAME)提取原名，再拼.php，避免str_replace('.old.php', '.php', $file)错伤backup.old.php.bak - 移动多个文件归目录：PhpStorm 不允许多选
Move。正确做法是先建好app/Models/并标记为 Sources Root，再对每个文件单独F6→ Move，确保每一步都触发命名空间校验 - Linux/macOS 终端一行解决后缀：
rename 's/\.old\.php$/.php/' *.old.php；Windows 用 PowerShell：Get-ChildItem *.old.php | Rename-Item -NewName { $_.Name -replace '\.old\.php$', '.php' } - 脚本或命令只动文件系统，不碰代码引用——后续必须人工跑
Ctrl+Shift+R替换所有旧路径字符串
Replace in Path 是补漏核心，但 Scope 和匹配精度必须亲手设
批量改完文件名后发现大量 require 'User.php' 还没更新？Ctrl+Shift+R（macOS 是 Cmd+Shift+R）是唯一可靠手段，但它默认不工作，除非你调对参数。
- Scope 必须选
Project或自定义范围，不能留在Current File；vendor/ 目录默认被 Excluded，要补漏就得先右键取消排除 - 搜索内容填
User.php，替换为AdminUser.php，务必勾选Match case和Words only，否则MyUser.php会被误替成MyAdminUser.php - 动态拼接路径（如
$path = __DIR__ . '/controllers/' . $name . '.php';）无法被覆盖，只能人工检查逻辑 - 正则模式下，
\.php$要转义点号，$1引用捕获组，不是\1；中文搜索前确认文件编码是 UTF-8，且*.php归属 “PHP files” 类型
最易被忽略的是：文件移动或重命名后，composer dump-autoload 必须手动执行，否则 PSR-4 映射失效，Class not found 报错不会提示你缺这步。
