绝大多数composer install报错源于缓存残留、镜像失效或权限错配，须按错误关键词精准处理：如“file could not be downloaded”需切阿里云镜像、清缓存、删vendor与composer.lock并用-vvv验证真实请求地址。
绝大多数 Composer install 报错，不是代码问题，而是缓存残留、镜像失效或权限错配导致的——直接删 vendor 或重试没用，必须按错误关键词精准清理。
报 “file could not be downloaded” 或卡在 “Loading composer repositories”
这基本是网络链路问题，Packagist.org 直连在国内不可靠，TLS 握手失败或 DNS 污染都会触发。别怀疑 PHP 或 Composer 安装坏了。
- 立刻切阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（注意第三参数composer不能省，URL 末尾斜杠/必须有） - 切完必须清缓存：
composer clear-cache；Windows 用户还得手动删%LOCALAPPDATA%\Composer\cache - 删掉
vendor/和composer.lock——composer.lock里硬编码了旧源地址，不清它，换源也白搭 - 验证是否真走了镜像：
composer install -vvv 2>&1 | head -n 10 | grep Downloading，第一行 URL 才是真实请求地址；只看composer config输出没用
报 “Failed to extract” 或 “Corrupted zip file”
这不是网络问题，是 ~/.composer/cache/files/ 下某个 ZIP 文件损坏（比如下载中断、磁盘写异常），Composer 拿着坏包去解压就卡住，不会自动跳过。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 盯住
composer install -v输出末尾，找Extracting或Downloading后紧跟着的包名，比如symfony/console - 查缓存位置：
composer config --global cache-dir，进files/子目录，用包名模糊搜索：ls -l *symfony*console*.zip（Linux/macOS） - 只删匹配的 ZIP，别碰
repo/和vcs/——它们不参与解压流程 - 删完 ZIP 还报错？说明
composer.lock里硬编码的dist.sha256值和当前缓存 ZIP 不匹配。必须同步删vendor/和composer.lock，再跑composer install --no-cache --force-checksums
报 “Permission denied” 在 vendor/、composer.lock 或 ~/.composer/cache 路径上
别管“权限不足”这种模糊提示，直接盯终端输出中明确写出失败路径的那行。只要那一行显示 root 归属，就是所有权错配。
- 查归属：
ls -ld vendor/、ls -ld composer.lock、ls -ld $(composer config --global cache-dir)；只要任意一行第一列是root，就确认问题所在 - 修复归属：
sudo chown -R $USER:$USER vendor/ composer.lock；全局缓存同理：sudo chown -R $USER:$USER $(composer config --global cache-dir) - WSL 用户特别注意：
/mnt/c/下运行composer install极易因 Windows ACL 导致权限错乱，应把项目移到~/projects/等原生 Linux 路径下 - Docker 场景中，不要在宿主机用 bind mount 挂载后跑
composer install；应在Dockerfile里RUN composer install
报 “Could not find package” 或长时间静默不下载 packages.json
这不是包不存在，而是 Composer 根本没拿到 packages.json——索引文件都拉不下来，后续所有解析都无从谈起。
- 先验证镜像基础可用性：
curl -I https://mirrors.aliyun.com/composer/packages.json必须秒回HTTP/2 200和Content-Type: application/json - 确认 URL 是 HTTPS 且结尾带
/：写成https://mirrors.aliyun.com/composer（缺斜杠）会拼出非法路径/composerpackages.json - 别信
composer config -g repo.packagist的输出——它只告诉你“写了什么”，不等于“正在用什么”。真正生效得看composer diagnose输出中Repo packagist.org:那一行 - 必须执行三步清空：
composer clear-cache、rm -rf vendor/ composer.lock、再跑composer install（不是update）；Windows 用户注意composer clear-cache不会自动清理%LOCALAPPDATA%\Composer\cache下的repo子目录
最常被忽略的是 composer.lock ——它不是缓存，但里面硬编码了 provider 地址、dist URL 和哈希值，任何缓存清理动作都不动它；漏掉它，前面所有操作基本白做。
