核心矛盾是composer对一致性的强约束：只还原不修复，只校验不猜测；只要composer.lock完整可信，composer install就能100%复原原始依赖状态。
vendor 目录损坏或报 Class not found、autoload.php 找不到、Failed to extract 等错误，不是靠重装 PHP 或换镜像能解决的——核心矛盾是 Composer 对“一致性”的强约束：它不修复，只还原；不猜测，只校验。只要 composer.lock 完整可信，composer install 就能 100% 复原原始依赖状态。
为什么 composer install 有时不补全 vendor？
Composer 不校验 vendor 子目录内容完整性，只检查包目录是否存在。哪怕 vendor/monolog/monolog/src/ 是空的，只要 vendor/monolog/monolog/ 这个文件夹还在，它就认为“已安装”，跳过重建。
- 现象：
ls -la vendor/monolog/monolog显示目录存在，但里面没有src/或composer.json - 原因：手动删过子目录、中断安装、或权限导致解压失败后残留空文件夹
- 解决：必须用
rm -rf vendor/monolog/monolog彻底删除该包目录，再跑composer install—— 不要只删src/ - 注意：
composer update monolog/monolog在 lock 已锁定版本时根本不会触发下载，它不是“重拉命令”
composer install 报 “lock file is not up to date” 怎么办？
这不是缓存或网络问题，是 composer.json 和 composer.lock 出现逻辑断层：前者被改过（比如加了新 require），但没执行 composer update 更新 lock 文件，install 就拒绝执行。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 先运行
composer validate，确认报错来源 - 若
git status显示composer.lock是 modified，尤其注意 Windows/Linux 换行符差异（^M） - 不要直接删 lock 文件！先
git checkout -- composer.lock恢复原始 lock，再对比composer.json改动是否合理 - 如果改动是必要的，就执行
composer update --with-all-dependencies生成新 lock，而非绕过校验
缓存损坏比 vendor 缺失更难排查
~/.composer/cache（Windows 下是 %APPDATA%\Composer\Cache）里存着 zip 包和解压后的临时文件。哪怕你 rm -rf vendor 干干净净，Composer 仍可能从缓存里读取一个损坏的 zip，然后报 Failed to extract vendor/monolog/monolog。
- 优先执行
composer clear-cache，别跳过这步 - 确认缓存路径：
composer config --list | grep cache - 清完缓存后，再删 vendor，最后跑
composer install --no-cache（强制跳过缓存，但不改版本逻辑） - CI/CD 中建议固定加
--no-cache，避免不同机器因缓存状态不同导致构建结果不一致
vendor 被手动改过，composer install 直接中止怎么办？
Composer 把 vendor 当作只读快照。只要你改过 vendor/symfony/console/Command.php 一行注释，它就会报 Package vendor/symfony/console is not up to date. Changes will be discarded. 并 halt，这是保护机制，不是 bug。
- 唯一安全恢复方式是加
--discard-changes：composer install --discard-changes - 它不是简单覆盖，而是按 lock 文件对每个包做 diff + reset，保留 autoload 结构，比
rm -rf vendor && install更精准 - 别指望
composer dump-autoload或clear-cache能绕过这个检查——它们根本不碰 vendor 文件内容 - 长期修改必须走正规路径：fork + vcs、
cweagans/composer-patches、或 PSR-4 覆盖 +exclude-from-classmap
真正难的从来不是“怎么装”，而是判断当前状态是否可信：lock 是否干净、缓存是否完整、PHP platform 是否匹配、vendor 是否真为空目录——这些细节漏掉任何一项，重装都只是在重复错误。
