全局配置命令composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/必须严格包含三要素：-g、repo.packagist（单数）、composer类型值及带尾斜杠的HTTPS地址，缺一即静默失效。
直接说结论：全局配置一条命令就能生效，但90%的人配不成功，不是网络问题，是命令写错了三个关键点。
composer config -g repo.packagist 命令必须带齐三要素
这条命令不是“大概对就行”，漏掉任意一个都会静默失败，且不报错：
-
-g不能省——缺了就只改当前项目composer.json，换目录就失效 -
repo.packagist是唯一合法键名（注意是repo单数，不是repos；也不能写成packagist.org） -
composer是 type 值，不是可选参数，也不是注释——省略后 Composer 2.0+ 会 fallback 到官方源 -
https://mirrors.aliyun.com/composer/必须用 HTTPS，且末尾斜杠/不能少（少斜杠会拼出/composerpackages.json导致 404）
正确写法：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
验证是否生效：composer config -g repo.packagist，应输出类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。如果返回空、null 或报错，说明没写对。
项目级配置比全局更可靠，尤其适合团队协作
全局看着省事，但实际容易踩坑：
- 某些项目在
composer.json里写了"packagist.org": false，会直接屏蔽全局镜像 - CI 流水线常以
www或runner用户运行，而-g配的是当前登录用户的配置，权限不一致就失效 - 新人拉代码后行为不一致——全局配置无法被 Git 跟踪
推荐做法：进项目根目录，运行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉 -g）。它会自动在 composer.json 顶层写入 "repositories" 字段，key 固定为 "packagist"，不会覆盖已有私有源——前提是原来 repositories 是对象结构（不是数组）。
如果项目已存在 "repositories" 数组，别手动覆盖，用命令追加，否则可能误删私有包源。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
换源后 still stuck at “Resolving dependencies”？和镜像无关
镜像只加速下载，不解决依赖解析慢的问题。如果你发现 composer update 卡在 Resolving dependencies 几十秒甚至几分钟，基本可以确定是本地环境或 composer.json 写法导致的：
- PHP 版本约束太宽，比如
"php": "^7.4 || ^8.0"，会让 Composer 尝试大量组合 - 大量未锁定版本的
dev包（如"monolog/monolog": "dev-main"） -
require-dev里塞了太多工具链（phpunit、phpstan、psalm等混在一起）
临时切换镜像验证是否真卡在下载环节：composer install --repository-url=https://mirrors.aliyun.com/composer/。这个参数优先级最高，能绕过所有配置，适合排查。
注意：composer require 不支持 --repository-url，必须用 install 或 update。
换源后首次 install 报 hash 校验失败？删 vendor 和 lock 重来
这是常见现象，原因很直接：旧 composer.lock 记录的是从官方源下载的包 hash，现在走镜像源，虽然内容一致，但签名路径不同，Composer 会校验失败。
解决方法极简：rm -rf vendor composer.lock && composer install。
另外提醒：Composer 2.2+ 默认开启 fallback 机制——当镜像返回 404 或 503 时，会自动切回 packagist.org 查一次。所以哪怕镜像短暂不可用，也不会完全中断流程。
真正容易被忽略的点是：Windows 用户改完全局配置后，必须重启终端才能读到新配置；而 macOS/Linux 下，~/.config/composer/config.json 修改后立即生效。
