Composer config -g repo.packagist 失效主因是键名错（应为单数repo）、缺type值“composer”、URL末尾无/，三者任一出错均静默回退官方源，且项目级repositories字段会完全屏蔽该配置。
composer config -g repo.packagist 命令为什么总不生效
不是镜像源挂了，是命令写错三个地方就彻底失效，且完全不报错——你看到的“还是慢”，其实是根本没切过去。
-
repo.packagist不能写成repos.packagist（多一个 s，Composer 2.0+ 直接忽略） -
composer是 type 值，不是可选参数，漏掉就会 fallback 到官方源 - URL 必须用 HTTPS，且末尾必须带
/：比如https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会导致拼出/p2/packages.json类路径，404）
验证是否成功：运行 composer config -g repo.packagist，输出必须是完整 JSON，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或报错，说明没写进去。
项目级配置比全局更可靠，尤其要防 repositories 覆盖
全局配置看着省事，但实际在 CI、团队协作、多源项目里容易翻车：CI 流水线用的是 runner 用户，而 -g 配的是你本地登录用户的配置；某些开源项目 composer.json 里写了 "packagist.org": false，会直接屏蔽全局镜像。
- 进项目根目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g） - 它会自动在
composer.json顶层写入"repositories"字段，key 固定为"packagist" - 如果项目已有
"repositories"且是对象结构（不是数组），不会覆盖；如果是数组，别手动改，用composer config repos.<name> ...</name>追加，否则私有包源可能消失
换源后还卡在 “Resolving dependencies”？和镜像完全无关
镜像只加速元数据拉取和 ZIP 下载，不参与依赖解析。这个阶段卡住，99% 是 composer.json 写法或环境问题：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
"php": "^7.4 || ^8.0 || ^8.1 || ^8.2"这类宽泛约束会让求解器暴力穷举所有组合 -
"minimum-stability": "dev"强制拉取不稳定分支，候选版本数爆炸 -
composer.lock被删或未提交，install实际退化为update -
repositories里存在已下线的私有源，Composer 逐个超时才 fallback
快速定位：运行 composer config --list | grep repositories 看实际生效源；再跑 composer validate --strict 检查 lock 文件合法性。
自定义版本号范围限制导致依赖冲突，怎么收窄
宽泛版本约束（如 "monolog/monolog": "^1.0 || ^2.0 || ^3.0"）会极大拖慢解析速度，甚至让 Composer 求解器陷入死循环。这不是镜像能解决的问题。
- 优先锁定主版本：用
"^2.13"代替"^2.0 || ^3.0"，避免跨大版本兼容性试探 - 开发阶段可临时加
--with-all-dependencies强制重算，但上线前必须删掉 - 对 dev 包，明确指定 commit hash 或 tag：
"yiisoft/yii2": "dev-master#abc123"，禁用分支自动解析 - 删掉
require-dev里非必需的工具链（如phpunit/phpunit在生产环境不需要）
真正耗时的从来不是下载，而是 Composer 在几百个版本中找唯一解——约束越松，搜索空间越大，卡住就越久。镜像再快，也救不了一个写错的 ^。
