composer config -g repo.packagist 命令没生效是因为漏掉键名repo.packagist、type值composer或url末尾/，三者任一缺失均静默回退官方源；验证需输出完整json如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，空、null或纯字符串均失败。

composer config -g repo.packagist 命令为什么没生效

不是网络问题，是命令根本没写进配置文件——漏掉 repo.packagist 键名、composer type 值、或 URL 少了末尾 /，三者任一缺失，Composer 2.x 都会静默 fallback 到 https://packagist.org，不报错也不提示。

验证是否真写进去了，只看这一条命令输出：composer config -g repo.packagist。必须返回类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON；返回空、null、Key not found 或纯字符串（如 "https://mirrors.aliyun.com/composer/"），都说明失败。

• repo.packagist 是固定键名，写成 repos.packagist 或 packagist.org 全无效
• composer 是必需的 type 值，不是可选参数，也不能省略或替换成其他文字
• URL 必须是 HTTPS，且末尾必须带 /（https://mirrors.aliyun.com/composer/ ✅，https://mirrors.aliyun.com/composer ❌）
• Windows 用户配置路径在 %APPDATA%\Composer\config.json，Linux/macOS 在 ~/.composer/config.json，手动编辑极易出错，优先用命令写入

生产环境必须用项目级配置，而非全局

CI/CD 流水线、Docker 构建、宝塔部署默认以 www 或 runner 用户运行，根本读不到你本地 root 或 $USER 的全局配置。项目级配置写进 composer.json，Git 可追踪、所有人行为一致，才是生产环境唯一可靠方式。

进项目根目录执行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意不加 -g）。它会自动处理已有 repositories 字段：

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

• 如果 "repositories": {}，就安全写入 "packagist" 子项
• 如果 "repositories": []（数组），命令会直接报错，需先手动改为对象再执行
• 已有私有源时，只要原结构是对象，就不会覆盖，而是合并
• 切忌手写 "packagist.org": false —— 这会彻底关掉回退机制，镜像临时不可用时 composer install 直接失败

换源后仍卡在 “Loading composer repositories” 怎么排查

现象是日志里持续出现 Downloading https://packagist.org/packages.json 或 ZIP 地址，说明请求根本没发到镜像站。这不是镜像失效，而是配置被覆盖或缓存残留。

• 先删缓存：composer clear-cache
• 删旧状态：rm -rf vendor/ composer.lock
• 强制重拉：composer install --no-cache -vvv，观察日志里真实请求域名是否含 mirrors.aliyun.com
• 检查 composer.json 是否存在 "repositories": {} 或空数组 —— 即使内容为空，也会屏蔽全局镜像
• 运行 composer diagnose，确认 secure-http: OK；若为 disabled，说明跳过了 HTTPS 校验，存在风险

阿里云镜像地址和备用方案

阿里云镜像地址为 https://mirrors.aliyun.com/composer/，稳定、同步及时，是生产首选。但单一镜像存在单点风险，建议提前准备备用方案。

• 腾讯云镜像：https://mirrors.cloud.tencent.com/composer/，部分场景稳定性更高
• 华为云镜像：https://repo.huaweicloud.com/composer/，注意部分路径需手动补 /composer 后缀
• 临时切换（不改配置）：composer install --repository-url https://mirrors.tencent.com/composer/
• 旧版 Composer（1.x）不支持 HTTPS 镜像，升级到 composer self-update 至 2.5+ 可避免 TLS 握手卡顿

最易被忽略的是：改完配置后没删 composer.lock，导致锁文件里仍记录着 packagist.org 的元数据地址，下次 install 依然走官方源。