Composer镜像配置无效的主因是repo.packagist键名错误、缺composer类型值、URL末尾无/，三者缺一即静默回退官方源；验证须执行composer config -g repo.packagist输出完整JSON或正确URL，且宝塔/CI等环境需按实际运行用户（如www）单独配置。
不配镜像，Composer 在国内基本跑不动——不是慢，是大概率卡死在 Loading composer repositories 或 Downloading packages.json；配错则静默失效，你根本不知道自己还在直连 packagist.org。
为什么 composer config -g repo.packagist 总是没生效
这条命令不报错、不提示，但漏一个字符就回退到官方源。三个硬性条件缺一不可：
-
repo.packagist是固定键名，写成repos.packagist（多 s）、packagist.org或大小写混用（如Repo.Packagist）全无效 - 第二个参数
composer是type值，必须显式写出，不能省略、不能当注释、不能替换成composer2 - URL 必须以
https://开头，且末尾带/：例如https://mirrors.aliyun.com/composer/✅，而https://mirrors.aliyun.com/composer❌（少斜杠会导致请求路径拼成/composerpackages.json直接 404）
验证是否写入成功，只看这一行输出：composer config -g repo.packagist
正确结果要么是完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，要么是纯 URL 字符串（新版行为）。返回空、null、报 Key not found 或仍是 https://packagist.org，说明配置根本没进去。
宝塔、CI、Docker 里镜像不生效？用户身份没对上
全局配置写在当前用户的 ~/.composer/config.json，但宝塔「一键部署」默认用 www 用户跑，GitHub Actions 默认用 runner 用户，它们读不到你 root 或个人用户下的配置。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 在宝塔终端执行
whoami确认实际用户（通常是www），再切过去重配：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - CI 脚本中别依赖全局配置，改用临时参数更可靠：
composer install --repository=https://mirrors.aliyun.com/composer/ - Docker 构建时，确保
USER指令与配置用户一致，或直接在构建阶段用COMPOSER_HOME显式指定配置路径
Resolving dependencies 卡住？这不是镜像问题
这个阶段不走网络，但极度吃 PHP 资源和环境配置：
-
memory_limit过低（如 128M）会导致依赖图解析失败重试——临时加COMPOSER_MEMORY_LIMIT=-1再试 - 启用了
xdebug（运行php -v可确认），会让解析慢 5–10 倍——用php -d xdebug.mode=off $(which composer) install临时禁用 -
platform配置与实际 PHP 版本不匹配（如"php": "7.4"却在 PHP 8.2 上运行），触发降级查找逻辑 -
composer.lock残留已下线包的引用，导致回退搜索——删掉vendor/和composer.lock，再用composer install --no-cache
并发下载和跳过冗余环节才是真提速关键
换镜像只是第一步，真正压资源、提速度要靠三件事：
- 设并发数：
composer config -g http-max-concurrent-downloads 10（新版 Composer 已弃用parallel-downloads，别再用）；内网或低配机器建议设为 6–8，超 10 容易触发file_put_contents(/tmp/): failed to open stream - 安装时加减负参数：
composer install --prefer-dist --no-autoloader --no-scripts；最耗资源的不是下载，是自动 dump autoload 和执行 post-install-cmd 脚本 - 完成后单独补 autoload：
composer dump-autoload；CI 中务必缓存~/.composer/cache，并禁用COPY vendor
最后提醒一句：项目里已有 repositories 字段，就别指望全局配置生效——优先级是项目级 > 全局 > 默认源，哪怕 "repositories": {}（空对象）也会屏蔽全局镜像。
