Composer镜像配置未生效的根本原因是必须显式设置{"packagist.org": false}作为repositories数组首项，且URL末尾须带/、需执行clear-cache并删除composer.lock重新生成，否则仍fallback至官方源。
composer config --global repo.packagist 配置为什么没生效
根本原因是 Composer 3.x+ 硬编码了元数据请求路径，repo.packagist 这个配置项必须显式设置，否则所有 packages.json、provider-*.json 请求仍直连 packagist.org，和 repositories 数组无关。
常见错误包括：
- 手写
~/.composer/config.json时格式出错（少逗号、引号不闭合），导致后续所有composer命令报 JSON 解析失败 - 在 Windows 上用 Git Bash 执行
composer config -g，但 PHP 实际运行用户是www-data或SYSTEM，配置写到了错误的%APPDATA%路径下 - CI 容器里
/root/.composer是空目录，composer config -g写入后未验证是否被挂载或保留
验证是否生效，直接运行：composer config repo.packagist
输出应为 https://mirrors.aliyun.com/composer/（注意末尾必须有 /）；若为空或报错，说明配置未落盘或被覆盖。
composer.json 的 repositories 数组怎么写才真正禁用 packagist.org
只加一条 "repositories": {"packagist.org": {"type":"composer", "url":"https://mirrors.aliyun.com/composer/"}} 是无效的——Composer 2.2+ 会忽略它，元数据仍走硬编码源。
必须用数组格式，且第一项必须是独立对象 {"packagist.org": false}：
"repositories": [
{"packagist.org": false},
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"},
{"type": "composer", "url": "https://your-private-repo.com"}
]
关键细节：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
{"packagist.org": false}必须是单独一项，不能合并进下一项 - 镜像
url末尾必须带/，否则请求变成https://mirrors.aliyun.com/composer/packages.json（404） - 私有仓库放第二项之后，别删掉首项，否则官方包元数据又会 fallback 到
packagist.org
改完镜像后 vendor 还是从 packagist.org 下？
不是网络问题，是 composer.lock 里存的是旧 dist URL 和校验和，Composer install 完全不查新配置，直接按 lock 文件下载。
必须手动清理才能触发重新解析：
- 删掉
vendor/和composer.lock（二者缺一不可） - 再执行
composer install，它才会读取新的repositories并生成全新 lock 文件 - CI 脚本里要显式加
rm -f composer.lock && rm -rf vendor，否则缓存会复用旧 lock
别信 composer update --dry-run 的输出，它不验证元数据源是否生效，只模拟依赖图计算。
跨国团队怎么避免镜像同步延迟导致构建漂移
阿里云、腾讯云镜像都有 5–30 分钟同步延迟，同一时刻不同地区节点看到的可用版本可能不一致，composer.lock 在北京生成、在新加坡 install，很可能装出不同版本。
最稳的做法不是“统一换镜像”，而是让所有环境明确使用同一元数据源：
- CI 流水线开头强制设源：
RUN composer config -g repo.packagist composer https://packagist.org - 项目根目录放
.env.composer提示开发者该用哪个源，但不自动写入配置 - 禁止在
composer.json里写死镜像（尤其跨国项目），repositories数组只留给私有包
镜像只提速，不改依赖解析逻辑；而元数据一致性，才是 composer.lock 能还原快照的前提。这点最容易被忽略——大家盯着下载速度，却忘了 lock 文件本身是基于某一时点的元数据快照。
