必须带齐三要素：-g、repo.packagist（单数键名）、composer（type值）及完整https镜像url（含末尾斜杠），缺一即静默失效；验证需执行composer config -g repo.packagist确认输出为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，并清缓存、更新lock文件方可真正生效。
composer config -g repo.packagist 命令必须带齐三要素
这条命令不是“配个地址就行”，而是硬性三元组：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。漏掉任意一项，配置就静默失效——不报错、不提醒、install/update照旧卡在Loading composer repositories。
-
-g：必须加，否则只改当前项目composer.json，换目录即失效 -
repo.packagist：键名严格单数、全小写、无s；写成repos.packagist或Repo.Packagist会存进无效字段，查composer config -g repo.packagist返回null -
composer：这是type值，不是注释；省略它，Composer 2.x+ 会 fallback 到默认源，且可能报Repo is not configured properly -
https://mirrors.aliyun.com/composer/：协议必须是https，末尾/不可省；少一个斜杠，请求路径变成/composerpackages.json直接 404
验证是否真正生效不能只看命令有没有报错
执行完命令后，必须运行composer config -g repo.packagist，输出必须是完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。如果输出空、null、false，或只有 URL 没有type，说明没配对。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 检查
~/.composer/config.json（Linux/macOS）或%APPDATA%\Composer\config.json（Windows Git Bash），确认该文件里repo.packagist字段存在且结构正确 - 别信
composer diagnose的“OK”提示——它不校验镜像配置是否可用，只检查语法 - 真要验证下载效果，用
composer install -vvv | grep -i "downloading\|mirrors"，看到Downloading https://mirrors.aliyun.com/composer/...才算落地
换了镜像但 vendor 还是慢？问题大概率出在 lock 文件和缓存
镜像配置成功 ≠ 下载立刻变快。Composer 会优先从composer.lock里读取dist.url，而这个字段默认仍指向packagist.org。即使全局镜像已设，它也会先试一次境外地址，失败后才 fallback（且 fallback 不稳定）。
- 必须执行
composer clear-cache，清掉本地缓存的元数据（尤其是packages.json索引） - 必须执行
composer update --lock，强制重写composer.lock中所有包的dist.url为镜像地址 - 新项目用
create-project时，建议直接加--repository=https://mirrors.aliyun.com/composer/，绕过 lock 文件旧引用 - 查看
composer.lock里任意一个包的dist.url字段，确认是https://mirrors.aliyun.com/composer/dists/...类路径
不同场景下该用哪种切换方式
全局配置不是万能解法。CI 构建、多用户环境、私有包混合项目里，-g反而容易被覆盖或冲突。
- 个人开发机：用
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/最省心 - CI 脚本或临时验证：用
composer install --repository=https://mirrors.aliyun.com/composer/，单次生效，不污染环境 - 团队项目需统一源：删掉
composer.json里的repositories数组，改用全局配置；若必须保留项目级配置，确保"packagist.org": false显式关闭默认源，再加镜像 - 华为云/腾讯云用户：URL 路径结构不同，别只换域名——华为云是
https://mirrors.huaweicloud.com/repository/php/，腾讯云是https://mirrors.cloud.tencent.com/composer/，末尾/同样不能少
install，结果还是卡在 downloading，本质是旧链接还在 lock 里躺着。
