Composer全局镜像配置生效需同时满足三个硬性条件：字段名必须为repo.packagist（单数）、type值必须显式写为composer、URL末尾必须带/，缺一不可。
composer config -g repo.packagist 为什么总不生效
根本不是网络或权限问题，是三个硬性条件缺一不可：repo.packagist（单数，不能写成 repos.packagist）、composer（必须显式写出 type 值）、URL 末尾必须带 /。漏掉斜杠会拼出 https://mirrors.aliyun.com/composer/packages.json 这类 404 路径；漏掉 composer 这个 type 值，配置就只是字符串，不被识别为仓库对象。
常见错误现象：
-
composer config -g repos.packagist ...→ 多了个s，写进无效字段，composer config -g repo.packagist输出为空 -
composer config -g repo.packagist https://mirrors.aliyun.com/composer/→ 少了composertype 值，新版直接忽略 -
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer→ URL 缺尾斜杠，请求路径变成/composerpackages.json
项目级 repositories 配置为何比全局更可靠
微服务或多项目环境下，全局镜像极易导致构建不可复现：A 服务用腾讯云镜像，B 服务 CI 脚本默认走阿里云，C 服务又混搭私有源——同一份 composer.lock 在不同环境 install 出的包版本可能不一致。
实操建议：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 用
composer config repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/（不加-g）向当前项目composer.json的repositories字段追加条目，不覆盖已有私有源 - 必须手动确保
repositories中存在"packagist.org": {}键（不是"packagist"或"default"），否则 Composer 2.9+ 会忽略该镜像项 - 若项目已有
repositories，推荐直接编辑composer.json，写成：{"packagist.org": {}, "my-internal": {}}，再执行composer install --dry-run观察下载 URL 是否已切换
换镜像后仍卡在 Downloading 的真实瓶颈在哪
镜像只加速 dist 包下载，不解决依赖解析阶段（Resolving dependencies）的卡顿。如果 composer update 卡在这里，和镜像无关，要查本地环境：
-
COMPOSER_MEMORY_LIMIT=-1临时加内存，PHP 默认 128M 不够解析复杂依赖图 -
php -d xdebug.mode=off $(which composer) install关掉 Xdebug，它会让解析慢 5–10 倍 - 检查
config.platform.php是否与实际 PHP 版本匹配（如设为"7.4"却在 PHP 8.5 上运行），会触发降级查找逻辑 -
composer clear-cache必须紧跟换源操作之后执行——旧缓存里的packages（发布时间是 2026年8月13日）会干扰新镜像行为
阿里云 / 腾讯云 / 华为云镜像 URL 格式差异
各家镜像路径结构不同，不能套用同一模板。尤其注意华为云含 /repository/php/ 子路径，阿里云和腾讯云则直接到 /composer/。必须严格复制以下命令（空格、斜杠、大小写一个都不能错）：
- 阿里云：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 腾讯云：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ - 华为云：
composer config -g repo.packagist composer https://mirrors.huaweicloud.com/repository/php/composer/ - 中科大：
composer config -g repo.packagist composer https://packagist.mirrors.ustc.edu.cn/
清华旧镜像 https://packagist.phpcomposer.com 已下线，继续使用会报 Could not resolve host 或 cURL error 60。
