必须正确配置repo.packagist全局镜像，即执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，四要素缺一不可：键名单数无s、type值为composer、URL用HTTPS且末尾带斜杠、加-g参数；否则静默失效，仍走packagist.org。
独立开发者用 Composer 效率翻倍，核心不是“换更快的镜像”，而是让 composer install 每次都走对路、不回退、不卡死——90% 的慢，源于配置写错却毫无报错提示。
为什么改了镜像还是走 packagist.org？
Composer 2.2+ 把 packagist.org 当作硬编码权威源，不看你写的 repositories 数组；只有显式配置 repo.packagist，元数据请求（如 packages.json）才会转向镜像站。多数人卡在这一步，却以为是网络问题。
-
composer config -g repos.packagist❌ 多一个s，命令不报错但完全无效 - URL 少末尾斜杠：
https://mirrors.aliyun.com/composer→ 请求变成/composerpackages.json，404 后静默 fallback 回官方源 - 用 HTTP 地址：
http://...被 Composer 2.0+ 默认拦截，直接跳过 - Windows 用户改完没重启终端，PHP 进程读不到新配置
全局配置怎么写才真正生效？
执行这条命令，四要素缺一不可：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
验证是否成功，别信命令输出，运行：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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/"}
- 空、
null、或只显示 URL 字符串 → 没写进去（常见于权限不足或 Composer 版本低于 2.0） - Linux/macOS 下检查
~/.config/composer/config.json是否含该字段 - CI 或 Docker 构建若用
sudo执行配置，实际构建用户可能读不到 root 的配置
项目级配置更适合协作和 CI
全局配置在团队中容易因环境差异失效；项目级配置写进 composer.json，所有环境行为一致，且能与私有源共存。
- 进项目根目录，运行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g） - 它会自动在
composer.json的repositories里加一条"packagist"键，不会覆盖已有私有源 - 已有
"repositories"且含 Git/Satis 源？手动编辑更安全：在repositories内加"packagist": { "type": "composer", "url": "https://mirrors.aliyun.com/composer/" }，并在根节点加"packagist.org": false - 换源后首次
composer install若报 hash 不匹配，删掉vendor/和composer.lock重来即可
卡在 “Loading composer repositories” 30 秒？不是镜像没配好
Composer 默认单源等待 30 秒才放弃——它不判断连接失败，只等满时间。DNS 慢、TLS 握手卡、IPv6 fallback 都会拖满这 30 秒。
- 临时缓解：
composer config -g http.timeout 600（拉到 10 分钟） - 更治本：
COMPOSER_IPV4=1环境变量强制走 IPv4，绕过 IPv6 探测延迟（尤其在云主机或校园网） - 别堆多个镜像源：
repositories数组里放多个源，只有前一个返回 404（包不存在）才触发下一个；超时、502、证书错误都不会 fallback，只会死等 - ECS 或内网部署必须用内网地址，比如阿里云 ECS 应配
http://mirrors.cloud.aliyuncs.com/composer/，走内网省延迟、免流量
最易被忽略的点：镜像只加速元数据检索和 tarball 下载，不解决 Resolving dependencies 卡顿——那属于依赖树复杂度问题，和镜像无关。确认是否真走镜像，加 -vvv 跑一次 composer update，grep mirrors.aliyun.com 看请求域名就清楚了。
