直接执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 并清缓存，即可解决90%的Composer下载慢问题；命令必须严格为四部分、单数小写key、HTTPS结尾带/，否则静默失效。
直接执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就能解决 Composer 下载慢的问题，不需要改配置文件、不依赖代理、也不用重装。前提是命令写对、缓存清掉、验证到位——错一处就白忙活。
为什么 composer config -g repo.packagist 命令总不生效
不是网络问题，是命令本身被写错了。Composer 内部硬编码只认 repo.packagist（单数、全小写、没 s），写成 repos.packagist 或 repositories.packagist.org 都会静默失败，不报错也不生效。
-
-g缺失：漏掉它就只改当前项目，换目录就失效 -
composer类型值被省略：命令必须带四个部分——composer config -g repo.packagist composer https://...，少一个composer，2.0+ 版本会 fallback 到官方源 - URL 末尾缺
/：比如写成https://mirrors.aliyun.com/composer，请求路径会拼成/composerpackages.json，直接 404 - 用了 HTTP 地址：Composer 2.x 默认禁用非 HTTPS 源，会报
Invalid repository type
该用阿里云还是腾讯云镜像
阿里云目前最稳：全量同步、HTTPS 可靠、索引完整、持续维护。腾讯云默认开启 fallback（找不到包时自动试官方源），适合常装新发布包的场景，但偶发延迟——比如 laravel/framework v11.0.0 可能晚几小时上线。
- 设阿里云：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 设腾讯云：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ - 华为云地址已变更：必须用
https://repo.huaweicloud.com/repository/php/，旧地址mirrors.huaweicloud.com已返回 404
怎么验证镜像真生效了
不能只看命令有没有回显“成功”，得查三处：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 查配置：
composer config -g repo.packagist输出必须是完整 JSON，形如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 看诊断：
composer diagnose中 “Repo:” 行的域名必须匹配你配的镜像 - 抓真实请求：
composer show -p | head -3第一行显示的源域名要是镜像站；更彻底就跑composer update -vvv，日志里Downloading的 URL 应含mirrors.aliyun.com
执行完命令后务必运行 composer clear-cache，否则本地缓存的元数据仍指向旧源。
项目级配置比全局更可靠
全局看着省事，但在协作和 CI 场景下容易翻车：只要项目 composer.json 里写了 "repositories" 字段（哪怕空数组），全局配置就完全被覆盖；团队成员各自设不同全局源，composer.lock hash 还可能不一致。
- 只给当前项目换源：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g） - 它会自动在
composer.json顶层加"repositories"字段，key 固定为"packagist"，安全合并已有配置 - CI 流水线推荐用腾讯云源，fallback 更友好，避免因镜像同步延迟导致构建失败
私有包、GitHub 直链包（"type": "package"）、或启用了 packagist.org 强制白名单的项目，镜像不会生效——这时候得单独配 repositories，而不是指望全局切换。
