Rector 配置不生效是因为 PhpStorm 插件仅提供快捷入口，实际执行依赖命令行工作目录下的 rector.php；需确保在项目根目录运行、正确配置 External Tools 并使用匹配版本的 set 写法。
在 PhpStorm 中安装 Rector 插件后为什么 rector.php 配置不生效？
因为 rector 在 phpstorm 里不依赖插件读取配置，而是靠命令行调用时的路径和工作目录决定配置加载逻辑。官方插件（如 “rector” by tomas votruba）仅提供右键菜单快捷入口，实际执行仍走 rector process 命令，它默认只在当前工作目录下查找 rector.php 或 rector.yaml。
- 确保你在 PhpStorm 的 Terminal 中打开的路径就是项目根目录（即含
rector.php的目录） - 不要把
rector.php放在子目录（如tools/），否则需显式用--config指定路径 - 如果用了 Composer 全局安装 Rector，
vendor/bin/rector不存在，就无法自动识别项目级 autoloading，会导致规则报错“class not found”
怎么让 PhpStorm 右键直接对选中文件运行 PHP 8.0→8.1 升级规则？
不能只靠图形界面点几下——必须提前写好可复用的 rector.php 配置，并绑定到 PhpStorm 的 External Tools。
- 在项目根目录创建
rector.php，内容类似：
$parameters->set(Option::PATHS, [<font color="#0000FF">__DIR__ . '/src'</font>]); $parameters->set(Option::SETS, [<font color="#0000FF">'php80'</font>, <font color="#0000FF">'php81'</font>]);
- 进入 Settings → External Tools → + → Program：
– Program:vendor/bin/rector
– Arguments:process $FilePath$ --no-diffs --dry-run（先加--dry-run确认效果）
– Working directory:$ProjectFileDir$ - 勾选 “Show console when a tool is run”，避免执行无声失败
运行时报错 Class "Rector\Set\ValueObject\SetList" not found 怎么办？
这是 Rector 版本与配置写法严重不匹配的典型症状，常见于从旧版（0.x）升级到 1.x 后仍沿用老配置。
- Rector 1.0+ 已废弃
SetList，改用字符串常量，例如：'php80'、'doctrine-code-quality'，而非SetList::PHP_80 - 检查
composer show rector/rector输出版本号；若为v1.0.0+，必须删掉所有use Rector\Set\ValueObject\SetList和相关引用 - 升级命令建议统一用：
composer require rector/rector --dev，不要混用全局安装和项目本地安装 - 某些规则（如
DowngradePhp81To80Rector）需额外安装对应 set 包，比如rector/rector-downgrade-php
为什么批量升级后部分语法没变，比如 array_key_first() 还在 PHP 7.4 项目里？
Rector 默认只处理它明确知道如何安全替换的场景，而 array_key_first() 这类函数是 PHP 7.3+ 新增，降级（downgrade）需手动启用对应规则集，不是升级（upgrade）的默认行为。
- 升级（upgrade）指低→高版本：如 PHP 7.4 → 8.0，启用
'php80'即可 - 降级（downgrade）指高→低版本：如 PHP 8.1 → 7.4，要单独加
'downgrade-php74'等 set，并确认该 set 已安装 - 某些函数级替换（如
str_starts_with()）需配合--level php74或显式添加规则类名，不能只靠 set 名称 - 注意
--dry-run不会修改文件，但会漏掉因 autoloading 失败导致的规则跳过——务必先跑一次真实执行看日志
配置和规则边界比看起来窄，一个 set 名写错、PHP 版本参数漏传、甚至 vendor/autoload.php 加载失败，都会让某类变更静默失效。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
