Rector不能通过composer require rector/rector --dev直接运行，因其需绕过项目自动加载自行扫描类，否则导致类找不到、依赖冲突、内存溢出；正确方式是用composer create-project隔离安装，并严格配置路径、规则集和文件扩展名。
不能靠 composer require rector/rector --dev 装完就直接跑 —— 这是绝大多数人第一步就踩进的坑。Rector 不是普通 Composer 包，它必须在兼容的 PHP 环境中以独立工具方式运行，且严重依赖项目自动加载配置、PHP 版本对齐和显式规则声明。
为什么 composer require rector/rector --dev 常失败或静默无效
这不是安装命令错了，而是它只解决“把文件放进来”，没解决“能不能跑起来”。常见现象包括：
-
Class "RectorCoreApplicationRectorApplication" not found：Rector 自身类被项目 autoloader 错误覆盖或加载顺序混乱 - 执行
vendor/bin/rector process卡住、OOM 或无输出：PHP 内存限制未绕过，或底层nikic/php-parser版本不匹配源码语法（比如用 PHP 8.1 解析 PHP 5.6 的yield from） - 报
Could not find rector.php config file：配置文件缺失，而 Rector 默认不启用任何规则 - 改了代码但没生效：项目
composer.json的autoload没覆盖待处理目录（如只写了autoload-dev，Rector 默认不读）
必须手动创建的三个关键配置项
Rector 启动前，这三项缺一不可，漏掉任意一个都会导致失败或跳过文件：
-
rector.php：根目录下必须存在，内容必须返回static function (RectorConfig $config): void，不能包在嵌套闭包里（v0.23+ 和 v1.x 语法不兼容） -
composer.json中的autoload或autoload-dev：要重构的路径（如src/）必须已注册为 PSR-4 或 classmap，否则Class not found报错无法避免 -
--autoload-file参数（可选但常需）：若重构的是未纳入 autoload 的脚本（如bin/下 CLI 工具），必须显式传入--autoload-file vendor/autoload.php或在配置中加$config->autoloadPaths(['bin/'])
rector process 必须带的参数不是可选，是刚需
不加这些，90% 情况下会提示 “No files changed” 或直接退出：
立即学习“PHP免费学习笔记（深入）”；
-
--dry-run：首次运行必须加，否则改错没法回滚 -
--set php80（或php81、php82）：不指定 set，Rector 默认不启用任何规则；别信“自动检测版本”，它不会猜你目标 -
--paths="src,tests"或配置中$config->paths(['src', 'tests'])：默认只扫src和tests，其他目录（如app、lib）必须显式声明 -
--no-progress-bar：CI 环境下必加，否则因无 TTY 卡住
跨 PHP 版本升级时最容易忽略的兼容性断裂点
从 PHP 7.4 升到 8.2，不能只套 SetList::PHP_82 —— Rector 规则集不是全量覆盖，而是按版本分层设计：
- 必须逐级应用：先
php80，再php81，最后php82；跳版本会导致??=、match、enum等语法遗漏 - 第三方生态规则需额外启用：Laravel 项目不加
SetList::LARAVEL_10，@phpstan-ignore-next-line注解不会被清理；Doctrine 实体里的@ORMColumn(type="string")也不会转成属性类型 -
SetList::DEAD_CODE看似安全，但可能删掉被ReflectionClass动态调用的私有方法，上线前必须grep -r "new \\Reflection" .扫描反射入口
真正麻烦的从来不是装上 Rector，而是让它在你的项目里稳定识别、准确解析、可控变更 —— 那些没写进文档的 autoload 路径偏差、php-parser 版本隐性依赖、以及 setlist 的叠加顺序，才是重构落地时最常卡住的地方。
