composer config -g repo.packagist 命令静默失效因三要素缺一：键名必须为repo.packagist（非repos）、type值必须为composer、url须https且末尾带/；验证需输出完整json如{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}。
全局配置只有一条命令真正可靠：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，但写错任意一个字符——比如少个斜杠、多一个 s、漏掉中间的 composer ——就会静默失效，你根本不会收到报错，只会发现 composer install 依然卡在 Loading composer repositories from packagist.org。
为什么 composer config -g repo.packagist 总不生效
它不是网络问题，是 Composer 对字段校验极严，错一个就弃用，且不提示。必须同时满足：
-
repo.packagist是唯一合法键名：写成repos.packagist、packagist.org、Repo.Packagist全部无效 - 第二个参数
composer是强制type值，不能省略、不能替换为vcs或空字符串 - URL 必须是
https://开头，且末尾带/：例如https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（会拼出/composerpackages.json导致 404）
项目级配置怎么写才不覆盖私有仓库
在项目根目录运行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉 -g），但它有格式陷阱：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 该命令会向
composer.json的repositories字段写入新条目，前提是原字段是对象（如{"packagist": {}}），不是数组（[]）；若为数组，命令直接失败 - 如果已有私有源配置，比如
"repositories": [{"type": "vcs", "url": "git@..." }]，执行该命令会**清空整个数组**，只剩镜像项 - 安全做法：先手动编辑
composer.json，确保repositories是对象结构，并显式禁用官方源："packagist.org": false与镜像并列
create-project 为什么无视全局镜像
composer create-project laravel/laravel myapp 这类命令默认绕过 repo.packagist 配置，直连 packagist.org 下载 skeleton 包——所以即使全局配了，它照样慢。
- 必须显式加
--repository-url参数：composer create-project laravel/laravel myapp --repository-url=https://mirrors.aliyun.com/composer/ - 若用
laravel/installer，也得加--repository-url，否则它内部调用的仍是默认源 - 注意：这个参数只影响 skeleton 包下载，不影响后续
composer install，后者仍走你配好的镜像
验证是否真生效，别信“执行完就 OK”
配置后必须验证，最直接的方式是：
- 运行
composer config -g repo.packagist，输出必须是完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；空、null、或仍是https://packagist.org都说明没写进去 - 运行
composer diagnose，看Repo packagist is private是否出现；若显示Repo packagist.org，说明还在走官方源 - 临时跑一次
composer install --no-cache -vvv 2>&1 | grep -i "mirrors.aliyun"，日志里应出现请求域名；若出现packagist.org，说明镜像未命中
最容易被忽略的是：项目级 repositories 字段一旦存在（哪怕为空数组），就会完全屏蔽全局镜像；还有 composer.lock 会固化旧包地址，换源后务必删掉 vendor/ 和 composer.lock 再重装。
