直接换阿里云镜像可解决90%的composer install卡死问题，但需确保url末尾有斜杠、配置键名为repo.packagist、执行composer clear-cache、且项目级repositories未覆盖全局设置。
直接换阿里云镜像就能解决 90% 的 composer install 卡死、超时、404 问题——但前提是 URL 写对、配置生效、没被覆盖。
为什么执行 composer install 还是慢得像在等快递？
最常见原因不是网络差，而是根本没走镜像源。Composer 默认直连 https://packagist.org，国内多数环境会卡在 DNS 解析或 TLS 握手阶段，表现为 0 B/s、长时间无响应，甚至报 file could not be downloaded。
- 执行
composer config -g repo.packagist，如果输出是{"url": "https://packagist.org"}或为空，说明全局镜像没配，或配错键名（比如用了过时的repos.packagist） - 项目级配置优先级更高：运行
composer config -l | grep repositories.packagist，若返回带项目路径的行，说明composer.json里写了源，它正在覆盖全局设置 - URL 末尾斜杠不能少：
https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（部分 Composer 2.2+ 版本会静默 fallback 到官方源）
composer config -g repo.packagist 怎么写才真正生效？
这条命令必须写全参数格式，且依赖当前用户权限。它不改 composer.json，而是写入用户级配置文件（Linux/macOS 在 ~/.composer/config.json，Windows 在 %APPDATA%\Composer\config.json）。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 正确命令：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（注意composer是 type，不是拼写错误） - 验证是否生效：
composer config -g repo.packagist输出必须是完整 JSON，含"type": "composer"和带末尾斜杠的 URL - 如果之前用过旧写法（如
repos.packagist），先清理：composer config -g --unset repos.packagist - 宝塔、Jenkins、CI 环境中，执行用户可能不是你本人，需用对应用户身份运行该命令，或改用临时参数
项目已有 vendor 和 composer.lock，换源后还报 hash 不匹配？
镜像源切换后，composer install 仍会读 composer.lock 里的 dist URLs 和 hashes，而这些 URL 来自旧源（比如官方源），新镜像无法提供完全一致的包地址，导致校验失败。
- 最干净做法：删掉
vendor/和composer.lock，再执行composer install（不是update） - 如果不想丢 lock 文件，可强制重生成：
composer update --lock，但它会忽略 lock 中的版本锁定，效果等同于先删 lock 再 install - 项目级配置写入
composer.json后，务必确认没有"packagist.org": false放在repositories外层（应放在根节点），否则镜像可能被禁用
CI 构建或团队协作时怎么安全换源？
全局配置在 CI 中常因用户隔离失效；直接改 composer.json 又容易污染协作环境。临时参数是最可控的方式。
- 不改任何配置文件，仅本次生效：
composer install -vvv --repository-url=https://mirrors.aliyun.com/composer/ - 加
-vvv能看到实际请求的 URL，确认真走了镜像（比如日志里出现GET https://mirrors.aliyun.com/composer/packages.json） - GitHub Actions 等平台建议显式设置：
COMPOSER_HOME: /tmp/composer+ 用composer config写入临时配置，避免读取缓存的旧全局配置 - 切记：镜像只加速下载，不解决依赖冲突。如果
composer install报Your requirements could not be resolved，问题大概率出在composer.json的版本约束太死（如写死"monolog/monolog": "1.23.0"），而非镜像本身
镜像不是万能解药，但它是所有 Composer 问题的第一道排查线——URL 格式、配置层级、用户上下文、lock 文件残留，四个点漏一个，就等于白配。
