composer config -g repo.packagist 命令必须严格包含三要素：键名 repo.packagist、type 值 "composer"、url 末尾带斜杠，缺一不可，否则静默失效且 install 仍走官方源。
composer config -g repo.packagist 命令必须带斜杠和 type 参数
这条命令不是“试试看”，而是三要素缺一不可：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。漏掉末尾的 /，或少写中间那个 composer（它是 type 字段值，不是命令名），就会静默失效——composer install 照样卡在 0 B/s，日志里还是 packagist.org。
常见错误现象：
-
composer config -g repo.packagist https://mirrors.aliyun.com/composer/—— 缺composertype，Composer 当没这回事 -
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer—— 少斜杠，部分 Composer 2.2+ 版本返回 404 或 fallback 到官方源 -
composer config -g repos.packagist ...—— 多个s，键名错，完全不生效
验证是否写对：运行 composer config -g repo.packagist，输出必须是完整 JSON，形如：
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}注意 url 末尾有且仅有一个 /，type 是小写 "composer"，不是空字符串、"vcs" 或其他。
项目级配置会清空整个 repositories 字段
进项目目录后执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g），不是“添加镜像”，而是全量替换 composer.json 里的 repositories 对象。哪怕你原来配了私有 Git 源，也会被一键抹掉。
使用场景：
- CI 脚本中临时指定源，避免依赖全局配置
- 多源协作项目需为当前项目单独锁定镜像
如果想保留原有私有仓库，得手动编辑 composer.json，把阿里云镜像作为 "packagist" 子项写入 repositories，并确保根节点有 "packagist.org": false。否则，composer require 可能报 Could not find package。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
已有 composer.lock 的项目切镜像必清缓存+重装
composer.lock 文件里硬编码了包的 dist URL 和哈希值，这些路径来自旧源（比如 packagist.org）。直接换镜像后，Composer 仍按原路径去阿里云找 zip 包——但阿里云的路径映射和官方不同，结果就是校验失败、下载中断、甚至 silently skip。
正确做法：
- 删掉
vendor/目录 - 删掉
composer.lock - 运行
composer clear-cache - 再执行
composer install
别指望 composer update 自动修复——它只更新依赖关系，不重写 lock 文件中的 dist 地址。
全局配置在宝塔、CI、IDE 中容易被忽略
composer config -g 写的是当前用户的配置文件：~/.composer/config.json（Linux/macOS）或 %APPDATA%\Composer\config.json（Windows）。但在宝塔面板、Jenkins 或 systemd 服务里，真正跑命令的用户可能是 www、jenkins 或 root，不是你登录 shell 的账号。
排查要点：
- 在宝塔 PHP 管理器里部署前，先用目标用户身份执行
composer config -g repo.packagist，看是否输出预期 JSON - CI 脚本中不要依赖全局配置，改用
composer install --repository-url=https://mirrors.aliyun.com/composer/ - PHPStorm 等 IDE 会缓存 Composer 配置，改完全局设置后必须重启 IDE
最可靠的验证方式永远是 composer require monolog/monolog -vvv 2>&1 | grep "Downloading"，看到域名是 mirrors.aliyun.com 才算真生效——别信 config -g 的输出，它只告诉你“写了什么”，不告诉你“正在用什么”。
