答案是三要素缺一不可：键名必须为repo.packagist（单数）、type值必须显式写composer、URL须HTTPS且以/结尾；任一缺失均静默回退官方源，且不报错。
配中文镜像不是“换地址就行”，而是三要素缺一不可：键名必须是 repo.packagist（单数、小写、无 s），composer 是 type 值（不是可选参数，更不是命令名），URL 必须是 HTTPS 且以 / 结尾。漏掉任意一个，Composer 都会静默 fallback 到 https://packagist.org，你看到 composer config -g repo.packagist 有输出，不代表它真在用镜像。
为什么 composer config -g repo.packagist 看起来成功却没生效？
常见错误现象：命令执行无报错，composer config -g repo.packagist 输出为空或 null，composer install -vvv 日志里仍出现 GET https://packagist.org/...。
-
repo.packagist写成repos.packagist（多一个 s）：新版 Composer 会静默忽略，不报错也不写入 - 漏掉
composer这个 type 值，例如写成composer config -g repo.packagist https://mirrors.aliyun.com/composer/：Composer 2.0+ 直接跳过该配置，fallback 到官方源 - URL 少了末尾
/，比如https://mirrors.aliyun.com/composer：请求会拼成/composerpackages.json，返回 404 - 用了 HTTP 协议：Composer 2.9.6 默认拦截非 HTTPS 源，直接拒绝连接
项目级配置为什么比全局更可靠？
全局配置写在 ~/.composer/config.json，但项目根目录下的 composer.json 中一旦存在 repositories 字段，就会完全屏蔽全局设置——不是“优先级低”，是彻底跳过，且不提示。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 团队项目常自带空
"repositories": {}或"packagist.org": false，这是 Laravel 脚手架等模板的默认行为 - CI/CD 流水线（如 GitHub Actions runner 用户）或宝塔后台（www 用户）运行命令时，读的是对应用户的
~/.composer/config.json，和你本地配置互不相通 - 推荐做法：进项目根目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g），它会安全合并进composer.json的repositories对象，key 固定为"packagist" - 如果
composer.json中repositories是数组（[]），该命令会失败；需先手动改为对象（{}）再执行
换源后依然报错或卡住，该查什么？
镜像只影响元数据和 ZIP 包下载路径，不解决依赖解析、PHP 扩展缺失或缓存污染问题。
-
composer clear-cache必须做：旧缓存里存的是官方源 URL 和 hash，不清掉，composer update仍可能校验失败或 404 - 删掉
vendor/和composer.lock再重装：lock 文件里的 hash 来自旧源，和镜像元数据不匹配会导致安装中断 - 验证是否真走镜像：加
-vvv参数运行composer install，日志中必须出现类似GET https://mirrors.aliyun.com/composer/p2/monolog/monolog.json的请求 - 卡在
Resolving dependencies？和镜像无关：检查composer.json中是否写了过宽的 PHP 版本约束（如"php": "^7.4 || ^8.0"），或大量dev-分支依赖
真正容易被忽略的是：配置命令的拼写、用户权限与缓存清理这三件事，它们共同决定镜像是否“实际生效”。哪怕 URL 正确、镜像稳定，只要其中一项没到位，你就还在直连 packagist.org。
