Shift+F6是唯一安全的重命名方式，基于语义分析精准更新当前作用域内真实引用，避免Ctrl+R文本替换导致的字符串误改、跨作用域污染及NameError等风险。
Shift+F6 是唯一安全的变量/方法/类重命名方式
直接 Ctrl+R 或多光标替换变量名，等于在代码里埋雷——它不区分字符串、注释、其他作用域里的同名符号，改完可能漏掉调用点或误伤无关内容。只有 Shift+F6 基于语义分析，只改当前上下文真正关联的引用。
光标停在哪，就重构哪：放在函数参数 $user_name 上，只影响该函数内对该参数的所有读写；停在 $this->data 的 data 上，会同步更新所有 $this->data =、isset($this->data)，但跳过 $_POST['data'] 和字符串里的 "data"。
- 未声明的局部变量（比如 if 块里直接用的
$result）可能识别失败，先加一行$result = null;再按Shift+F6 - 动态调用如
call_user_func([$obj, $method])、反射如class_exists('OldName')、路由注解里的路径名，Shift+F6完全不处理，必须人工核对或Ctrl+Shift+F全局搜原名 - 重命名后若移动了类文件，
composer.json里 PSR-4 映射路径不会自动更新，必须手动运行composer dump-autoload，否则报Class not found
Refactor → Rename（Shift+F6）也能重命名文件，但仅限单文件
右键文件 → Refactor → Rename 或直接按 Shift+F6，不仅能改文件名，还会自动更新项目中所有相关引用：包括 use 语句、new User()、require 'app/Models/User.php' 这类硬编码路径（如果勾选了 Search in comments and strings），甚至 composer autoload 映射（需启用对应选项）。
但它不支持“选中 10 个 .old.php 文件，一键全改成 .new.php”——多选后点 Rename，IDE 只是挨个弹窗让你输新名，且不会跨文件更新引用。
立即学习“PHP免费学习笔记（深入）”；
- 想批量改后缀（如
config.old.php → config.new.php），别在 PhpStorm 里折腾，用终端命令更可靠：rename 's/\.old\.php$/.new.php/' *.old.php（Linux/macOS）、PowerShell 中用Get-ChildItem *.old.php | Rename-Item -NewName { $_.Name -replace '\.old\.php$', '.new.php' } - PHP 脚本改名时，必须用
pathinfo($file, PATHINFO_EXTENSION)提取扩展名再拼新路径，不能靠str_replace('.old.php', '.new.php', $file)，否则遇到my_old.php_config.php这类名字就炸 -
rename()返回布尔值，务必检查：若!rename($oldPath, $newPath)，要打印error_get_last()['message']查原因
多文件批量改名只能改名，不更新任何引用
按住 Ctrl（Windows/Linux）或 Command（macOS）多选文件 → 右键 → Refactor → Rename，输入新名后 PhpStorm 会为每个文件生成默认序号名（如 file.php → file_1.php）。这一步只改文件系统名称，完全不扫描、不更新任何代码里的引用。
适合场景：静态资源文件（icon_home.png → icon_dashboard.png）、配置文件（env.local.php → env.dev.php），它们不被 PHP 代码 import 或 new，也无命名空间依赖。
- 改完后，如果原文件被
require或use过，那些地方全部变成错误，得手动或用Ctrl+Shift+R（Replace in Path）补救 - 别指望多选 Rename 后 IDE 会帮你修
use App\Models\User;——它根本没这个能力 - vendor/ 目录下文件禁止用此方式重命名，Composer 锁文件和 autoloader 会立刻失效
批量改名后最易忽略的三件事
很多人改完就以为结束了，结果上线报错才发现漏了关键环节。不是功能没用，是边界条件没兜住。
-
composer dump-autoload必须手动跑，类路径变更后 IDE 不会替你执行，也不进 Git Hook - 硬编码路径字符串（如 JSON 配置里的
"class": "AppServicesOldName"、模板里<?php echo $username ?>对应的$_GET['username']键名）不在语义分析范围内，得靠Ctrl+Shift+F或正则全局扫 - 测试文件里对旧名的断言（如
$this->assertContains('User', $response)）容易被忽略，尤其是当测试没跑过或 CI 被跳过时
