直接运行composer install即可重建vendor目录，前提是composer.json和composer.lock均存在且未被修改；它严格按lock文件中的精确版本、哈希值和地址安装，确保与原环境完全一致。
vendor目录删了或损坏，直接composer install就行
只要composer.json和composer.lock都在，composer install就能重建出和原来一模一样的vendor/——它不看composer.json里的版本范围，只按composer.lock里记录的精确版本、哈希值和下载地址来拉包。
常见错误现象：
-
composer install报错“lock file is not up to date”，说明composer.json被改过但没跑composer update，此时install会拒绝执行 - 删了
vendor/但只删了子目录（比如留了个空vendor/autoload.php），composer install会跳过完整安装，变成增量更新，结果缺包不补
实操建议：
- 先确认
composer.lock文件存在且未被git status标为 modified（尤其注意 Windows/Linux 换行符差异） - 用
rm -rf vendor彻底清空，别只删里面几个包 - 运行
composer install --no-dev（如果原项目是用--no-dev装的，漏掉这个参数会多装一堆 dev-only 包）
为什么composer update不是恢复操作的正确选择
composer update会重新解析依赖树，忽略composer.lock，把"^2.0"这种范围解析成当前最新兼容版（比如2.10.0），可能引入不兼容变更。这不是恢复，是升级。
容易踩的坑：
- CI/CD 流水线里用了
update，不同机器装出不同版本，环境不可重现 - 只跑
composer update monolog/monolog，它的子依赖（如psr/log）不会自动升级，容易触发运行时 Class not found 或方法不存在 - 私有包认证失效时，
update卡在某个包不动，而install能更快失败并暴露问题
实操建议：
- 仅当
composer.lock丢失或损坏时，才考虑composer update；但必须加--with-all-dependencies，避免子依赖残留旧版本 - 想临时绕过 lock 文件又不想升级？用
composer install --no-cache更轻量，它强制重解包但不改版本逻辑
缓存损坏比vendor缺失更隐蔽，composer clear-cache要优先做
即使vendor/删干净了，Composer 仍可能从~/.composer/cache里读取损坏的 zip 包，导致Failed to extract vendor/package这类解压失败错误。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
使用场景：
- 反复
install都失败，但composer validate通过 - Windows 用户发现缓存路径是
%APPDATA%\Composer\Cache，不是~/.composer/cache - 公司用了私有 Packagist，但
composer config --global repo.packagist指向了已下线的镜像地址
实操建议：
- 先运行
composer clear-cache，再删vendor，最后install - 检查缓存路径：
composer config --list | grep cache - 离线环境部署前，务必在有网机上用
composer install --prefer-dist --no-scripts生成干净vendor/，再整体打包传过去
vendor/autoload.php找不到或Class not found，大概率不是vendor没装好
只要vendor/目录存在且autoload.php物理文件在，90% 的问题是路径或加载方式错了，不是 Composer 没装对。
常见错误现象：
-
require 'vendor/autoload.php'报错：Warning: require(vendor/autoload.php): failed to open stream - 类名写对了，但运行时报
Class 'Monolog\Logger' not found
实操建议：
- 确认当前工作目录是项目根目录（即含
composer.json的那一层），否则require是相对路径查找 - 不要手动复制
vendor/到其他项目——vendor/composer/autoload_*.php里写死了绝对路径，跨目录即失效 - 改过
composer.json里的autoload配置（比如加了classmap或files），记得补跑composer dump-autoload --optimize
真正容易被忽略的是composer.lock的哈希校验机制：哪怕只是用图形界面解压工具覆盖了vendor/，文件权限或时间戳变化也会触发Hash mismatch错误，后续所有命令都会失败。
