Rector 安装失败主因是 PHP 版本与依赖冲突：v1.x 需 PHP ≥8.0，旧版需 ^0.13；须检查 phpstan/phpunit 版本并用 --with-all-dependencies 或先更新依赖；配置须用正确规则名（如 Rector\Php80\Rector\If_\IfToNullCoalescingRector）和 SetList::PHP_80 等预设集，避免 init 生成的通用配置。
Composer 安装 Rector 失败：常见报错和解决路径
直接运行 composer require rector/rector --dev 却提示依赖冲突或版本不兼容？这不是你环境有问题，而是 Rector 对 PHP 版本和已装包有强约束。它不支持“随便装”，必须匹配当前项目实际栈。
常见错误现象：Root composer.json requires rector/rector ^1.0, found rector/rector[dev-main, 1.0.0, ..., 1.12.0] but these were not loadable 或 phpunit/phpunit is locked to version 9.5.27 and an update of this package was not requested。
- 先确认 PHP 版本：Rector v1.x 要求 PHP >= 8.0；若项目还在 PHP 7.4，只能用
rector/rector:^0.13（已停止维护，但能跑） - 检查已安装的测试/分析工具：比如
phpstan/phpstan、phpunit/phpunit版本过高时，会和 Rector 的 dev-dependency 冲突；可临时加--with-all-dependencies强制安装，但更稳妥的是先composer update phpstan/phpstan phpunit/phpunit对齐主流小版本 - 避免全局安装：Rector 不推荐
composer global require，不同项目 PHP 版本/规则差异大，容易命令找不到或规则不生效
配置 rector.php 时规则写错导致没效果
Rector 不是装完就自动改代码——它必须靠明确规则（Rule）驱动。空配置文件、错写规则类名、或用了已废弃的规则名，都会让 vendor/bin/rector process 看似跑完却毫无改动。
典型问题：SetList::PHP_80 写成 SetList::PHP80（少下划线），或把 SimplifyIfReturnRector 拼错成 SimplifyIfRector。
立即学习“PHP免费学习笔记（深入）”；
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 规则类名必须完整且大小写敏感：所有规则都以
Rector\开头，例如Rector\Php80\Rector\If_\IfToNullCoalescingRector - 优先用预设集（SetList）：如升级到 PHP 8.1，直接写
$parameters->set(Option::SETS, [SetList::PHP_81]);，比单条罗列更稳 - 本地调试建议加
--dry-run和--verbose：看到“0 files changed”时，先确认是否匹配了目标文件（默认只扫src和tests），必要时用--paths="app,lib"扩展
运行 rector process 卡住或改出语法错误
不是 Rector 崩溃，而是它在解析 AST 时遇到无法识别的语法（比如自定义宏、非标准注释、或混合了 Hack 语法），或规则之间互相干扰。最常发生在 Laravel、Nette 或旧 Symfony 项目里。
现象包括：命令长时间无响应、报 Could not process ... file, due to: "Internal error"、或生成带 ??? 或重复括号的 PHP 代码。
- 跳过可疑文件：用
--skip="path/to/problematic/File.php"或在配置中加$parameters->set(Option::SKIP, [__DIR__ . '/legacy']); - 禁用高风险规则：像
MoveVariableDeclarationNearReferenceRector或InlineArrayReturnRector在复杂嵌套逻辑中易出错，初期可先关掉 - 别一次升多个 PHP 大版本：从 PHP 7.4 → 8.2 不要一步到位；先
SetList::PHP_80，跑通再加PHP_81，避免规则叠加导致 AST 修复失败
为什么 rector init 生成的配置不能直接用
rector init 是个快捷入口，但它只给骨架，不感知你的项目结构、PHP 版本、框架类型或现有编码风格。生成的 rector.php 里默认启用全部 PHP 集合，实际几乎必然冲突。
比如它可能默认加上 SetList::CODE_QUALITY，结果把你的 array() 全转成 []，而项目规范要求保留长数组写法；或者启用了 TypedPropertyRector，但你的属性还没加类型声明，直接加会导致类型不匹配报错。
- 删掉 init 生成的全部
rules数组，只留sets和paths - 用
vendor/bin/rector list查看当前可用规则，结合grep过滤：如vendor/bin/rector list | grep -i "php81" - 修改前备份：Rector 不做 Git commit 自动化，务必自己
git stash或git checkout -b rector-try，改崩了能秒退
真正难的不是装上 Rector，而是判断哪条规则在你这段代码里会把逻辑改歪——它不验证业务正确性，只按 AST 规则机械替换。多看 diff，少信 --auto-approve。
