Rector安装失败主因是PHP版本不匹配或镜像源限制，应按项目PHP版本选对应Rector版本、切回官方源；使用需选准规则集组合、正确配置rector.php、显式指定路径和引导文件，并严格对齐目标PHP版本。
Composer 安装 Rector 失败：常见报错和解决方法
直接运行 composer require rector/rector --dev 失败，大概率是 PHP 版本或 Composer 仓库策略问题。Rector 本身对 PHP 版本要求严格，比如 v1.0+ 要求 PHP 8.0+，而旧项目常卡在 PHP 7.4；另外，某些公司内网镜像会屏蔽 dev 包或限制 packagist.org 的元数据同步。
- 先确认本地 PHP 版本：
php -v，若低于 8.0，别硬装高版本 Rector，改用rector/rector:^0.19（支持 PHP 7.4） - 临时切回官方源再安装：
composer config -g repo.packagist composer https://packagist.org，再重试 - 如果提示
Root composer.json requires rector/rector ^1.0 -> found rector/rector[...]后面一堆 conflict，说明你项目里已有其他依赖锁死了旧版 Symfony 或 PHP-Parser，得加--with-all-dependencies或手动删vendor/+composer.lock再装
用 Rector 升级 PHP 语法：选对规则集比写配置更重要
Rector 不是“一键升级”，它靠规则（Rule）驱动，而规则集（SetList）决定了重构范围。乱套用 SetList::PHP_80 可能把 array() 全改成 []，但漏掉更关键的 ??= 或 match 替换——因为那些属于 SetList::PHP_80 之外的独立规则。
- 先跑一次检测模式看影响：
vendor/bin/rector process src --set php80 --dry-run，别急着加--autoload-file - 升级 PHP 版本时，优先组合使用：
--set php80 --set php81 --set php82（按目标版本叠），不是只选最高版 - 如果项目用了 Doctrine 或 Laravel，必须额外加
--set doctrine或--set laravel，否则@ORM\Column注解里的类型不会被更新 -
SetList::DEAD_CODE看似安全，实际可能删掉被反射调用的私有方法，上线前务必 grep 校验
配置文件 rector.php 怎么写才不踩坑
很多人复制教程里的 services()->set(...) 写法，结果运行时报 Class "Rector\..." not found，本质是自动加载没触发，或用了已废弃的 API。Rector v1.0+ 的配置结构和旧版完全不同，且不兼容。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 配置文件必须返回一个
Rector\Config\RectorConfig实例，开头固定是：use Rector\Config\RectorConfig; return static function (RectorConfig $config): void { ... }; - 加规则别用字符串类名：
$config->rule(DowngradeArraySpreadUsageRector::class)，而不是$config->rule('DowngradeArraySpreadUsageRector') - 排除路径必须用
$config->skip([...])，不能写parameters()->set(Option::EXCLUDE_PATHS, [...])（这是 v0.x 的写法，已移除） - 如果项目有自定义 autoloader（如 CodeIgniter），得显式指定：
$config->bootstrapFiles([__DIR__ . '/vendor/autoload.php']);
执行重构后为什么有些代码没变？
最常被忽略的是作用域限制：Rector 默认只处理 src/ 和 tests/，但很多老项目把逻辑塞在 app/、lib/ 或根目录 PHP 文件里。另外，它跳过无法解析的语法——比如混了模板语法（<?php echo $x ?>{{ $y }}）或注释里藏了伪代码。
立即学习“PHP免费学习笔记（深入）”；
- 手动指定路径：
vendor/bin/rector process app lib --set php80，别依赖默认扫描 - 遇到
Syntax error, unexpected T_STRING类报错，先用php -l xxx.php检查真实语法错误，Rector 不会修 PHP 解析失败的文件 - 匿名函数、动态调用（
$obj->{$method}()）、魔术方法（__get）相关的变更，Rector 默认不碰，得单独启用PrivatizeLocalVariablesToPropertyRector这类高级规则 - 改完别直接提交，用
git diff -w看空格变化，Rector 有时会意外重排缩进或换行
真正麻烦的不是装不上或跑不动，而是改了 200 个文件后发现某处 list() 被降级成 [$a, $b] = $arr，但 PHP 7.1 才支持，而线上是 7.0 —— 规则集和目标环境版本必须咬死对齐，差一个小数点都可能出事。
