composer不支持镜像权重或自动选最快，仅按repositories数组顺序查找首个返回有效元数据的源；必须显式禁用packagist.org并确保镜像type为composer且url正确，否则仍fallback官方源。
composer 不支持镜像权重配置，也没有自动最优选择机制。所谓“多个镜像自动选最快的”，是常见误解——它根本不会测速、不会轮询、也不会健康检查。
为什么改了 repositories 顺序却还是走官方源？
最常被忽略的是：项目级 composer.json 中的 repositories 会完全覆盖全局配置；而默认情况下，"packagist.org" 是隐式启用的，哪怕你写了阿里云镜像，只要没显式关掉它，Composer 就会在镜像失败后 fallback 回官方源。
检查当前实际生效的源：
composer config repositories
如果输出里还包含 "packagist.org": true 或没出现你的镜像 URL，说明配置没生效。关键操作包括：
- 在
composer.json的repositories数组顶部或中部加你的镜像，但必须带"type": "composer"和完整 URL - 在数组末尾加
{"packagist.org": false}—— 注意这是个开关项，不是仓库，不能漏掉引号和布尔值 - 删掉全局
~/.composer/config.json里重复的repos.packagist配置，避免干扰
多个镜像并列写进 repositories 有意义吗？
基本没有。Composer 只会用第一个返回有效元数据的源，后续源永远不会被访问。除非第一个返回明确的 404（包不存在），否则遇到超时、502、DNS 失败等，直接报错退出，根本不会查第二个。
典型无效配置：
"repositories": [
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"},
{"type": "composer", "url": "https://mirrors.tuna.tsinghua.edu.cn/composer/"},
{"type": "composer", "url": "https://packagist.org/"}
]
这种写法的问题在于：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 清华镜像永远不触发 —— 只要阿里云服务在线，哪怕响应慢，Composer 也会等满默认 30 秒才失败
- 官方源被显式列出，但没关掉隐式兜底，反而可能绕过你的镜像逻辑
- 两个国内镜像数据同步延迟一致，堆砌只是增加解析开销，不提升可用性
怎么让私有包 + 镜像 + 官方源共存且不冲突？
顺序决定一切：私有源必须最前，镜像次之，官方源仅作元数据兜底（且需手动补上 "packagist": true）。
正确结构示例：
"repositories": [
{"type": "vcs", "url": "https://gitlab.example.com/my-company/utils"},
{"type": "packagist", "url": "https://mirrors.aliyun.com/composer/"},
{"packagist": true}
]
注意三点：
-
"type": "vcs"是必须的，否则 Composer 不知道怎么解析 Git 仓库里的composer.json - 镜像用
"type": "packagist"而非"composer"，才能继承 packagist 全量索引能力（"composer"类型只认单个包定义） - 末尾的
{"packagist": true}是元数据兜底，不是下载源 —— ZIP 包仍从阿里云拉，但新包的packages.json索引可回退到官方源获取
真正影响体验的其实是缓存和网络超时
镜像配置再准，一旦遇到 DNS 慢、TLS 握手卡、CDN 节点抖动，composer install 就会卡在某个请求上不动。这不是优先级问题，而是网络层行为。
实操建议：
- 加
--no-interaction --prefer-dist减少交互和源码克隆开销 - 调大
process-timeout：在composer.json的config里设"process-timeout": 600 - 临时切换镜像用环境变量更可靠：
COMPOSER_REPO_PACKAGIST=https://mirrors.tuna.tsinghua.edu.cn/composer/ composer install - 别依赖
fxp-asset配置 —— 它早在 Composer 2.0 就被废弃，现在写进去也没用
最易被忽略的一点：镜像源的「可用性」不等于 Composer 的「健壮性」。你无法靠堆配置来掩盖网络不可靠的事实，能做的只是让失败更快暴露、路径更可控。
