90%的Composer安装超时因换源未真正生效：命令须写为composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（单数repo、带type、HTTPS且末尾有/），并按执行用户（如www）或项目级配置同步设置，否则仍走官方源。
换国内镜像源能显著降低 Composer 安装超时概率，但关键不在“换”，而在“换对”——90% 的超时问题其实根本没切成功，只是你以为切了。
composer config -g repo.packagist 命令为什么总不生效
命令写错三处中的任意一处，都会静默失败：不报错、不提示、install 仍卡在 Downloading 或直接 Connection timed out。
-
repo.packagist必须是单数，不能写成repos.packagist（多一个s就完全无效） - 必须显式带上
composer这个 type 值，即完整写成composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/；漏掉composer，Composer 2.x 会 fallback 回官方源 - URL 必须用 HTTPS，且末尾必须带
/，https://mirrors.aliyun.com/composer（缺斜杠）会导致请求路径拼成/composerpackages.json，直接 404
验证是否真生效：运行 composer config -g repo.packagist，正确输出应为类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或报错，说明没写对。
宝塔面板里换源后还是超时，其实是用户权限问题
宝塔后台的「一键部署」或计划任务，往往以 www 用户身份执行，而 composer config -g 默认写入的是 root 用户的 ~/.composer/config.json，www 根本读不到。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 先确认实际执行 Composer 的用户：在宝塔终端执行
whoami，再查对应用户的家目录下是否有.composer/config.json - 若需让
www用户也走镜像，切换到该用户再配：运行sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 更稳妥的做法是项目级配置：进项目根目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g），它会安全写入composer.json的repositories字段，不受用户权限影响
换源后依然卡在 Resolving dependencies 怎么办
镜像源只加速包下载（Downloading 阶段），不解决依赖解析慢的问题。如果 composer update 卡在 Resolving dependencies 几十秒以上，和镜像无关。
- 检查
composer.json中的 PHP 版本约束是否过宽，例如"php": "^7.4 || ^8.0"会让 Composer 尝试匹配大量版本组合 - 删掉
require-dev里非必需的工具链（如phpunit/phpunit、laravel/pint等），它们会显著拖慢解析速度 - 执行
composer update --dry-run -vvv查看详细解析过程，定位哪个包触发了深度回溯
注意：--repository-url=xxx 这种临时参数只对 install 和 update 有效，对 require 不起作用。
项目级配置比全局更可靠，尤其要提交到 Git
团队协作或 CI 场景下，全局配置无法被版本控制，新人拉代码后行为不一致，CI 流水线也可能因用户环境差异导致 composer.lock hash 不一致。
- 进项目根目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（无-g） - 该命令会自动在
composer.json顶层添加或合并"repositories"字段，key 固定为"packagist"，不会覆盖已有私有源（前提是原repositories是对象而非数组） - 换源后首次
composer install若报hash does not match，直接删掉vendor和composer.lock重来即可
阿里云镜像目前同步最及时、CDN 覆盖最广，地址是 https://mirrors.aliyun.com/composer/；腾讯云和华为云也可用，但要注意华为云路径含 /repository/php/，别漏掉。
