中小企业 Composer 镜像落地的核心矛盾是配置一致性：必须将标准格式 repositories 数组写入 composer.json 并提交 Git，切换前删 vendor/ 和 composer.lock，再用 --no-cache 重装，确保所有环境请求同一镜像 URL。
中小企业用 Composer 镜像，核心矛盾不是“选哪家”，而是“怎么让所有人、所有环境都稳定走同一镜像，且不因缓存/配置错位导致构建失败”。
为什么全局 config -g 在中小团队里基本失效
中小企业常靠几台开发机 + 1–2 台 CI 服务器（如 GitHub Actions 或自建 Runner）协作。但 composer config -g repo.packagist 写入的是每个用户的 ~/.composer/config.json，CI 容器启动时没有这个文件，Docker 构建用的是 root 用户，宝塔部署用的是 www 用户——它们读的压根不是同一个配置。
- 有人在自己电脑上配了阿里云镜像，
composer update很快；新人拉代码后直接composer install，却卡在Loading composer repositories，因为没配 - CI 流水线里跑出
Could not find package，查日志发现请求发到了packagist.org，而不是镜像站 - 误执行
composer config -g repo.packagist composer https://packagist.org，全队本地瞬间退回到公网源，没人知道谁改的
项目级 repositories 必须按标准数组格式写进 composer.json
把镜像地址写进项目根目录的 composer.json 并提交 Git，才是唯一能被所有环境一致读取的方式。但写法必须精确，否则静默失效。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 必须是数组结构：
"repositories": [ {"packagist.org": false}, { "type": "composer", "url": "https://mirrors.aliyun.com/composer/" } ] -
{"packagist.org": false}必须作为独立对象放在第一项，不能合并进下一项 -
url末尾必须带/，写成https://mirrors.aliyun.com/composer会导致请求拼成/composerpackages.json，返回 404 - 类型值必须是
"type": "composer"，写成"mirror"或"packagist"无效
切镜像前必须删 vendor/ 和 composer.lock
composer.lock 里记录的是 dist URL 和哈希值，这些字段来自上次生成 lock 时所用源。如果之前用的是官方源或旧镜像，lock 文件里的 dist.url 仍是 https://api.github.com/ 或 https://packagist.org/，那么即使你已配好新镜像，composer install 仍会直连原始地址——镜像只代理元数据，不自动重写 dist 下载链接。
- 切换镜像前，先运行
rm -rf vendor/ composer.lock - 再执行
composer install --no-cache -v，加-v可确认终端输出中真实请求的 URL 是否为https://mirrors.aliyun.com/composer/ - 不要保留旧
composer.lock，它和新镜像返回的元数据不匹配，大概率触发hash does not match或404 Not Found
同步延迟应对：别等，换+验+锁三步走
阿里云、腾讯云镜像同步延迟通常 5–15 分钟，高峰期可达 30 分钟。中小企业没法等镜像“自动追上”，得主动控制节奏。
- 发布新包后，先手动验证镜像是否已同步：
curl -s https://mirrors.aliyun.com/composer/p/vendor/package.json | jq -r '.packages."vendor/package" | keys[]' | sort | tail -3，对比官网结果 - 若镜像未同步，临时换华为云（同步延迟最低）或中科大源，命令加
--repository=https://mirrors.huaweicloud.com/repository/php/ - CI 中加入校验步骤：
composer install --dry-run 2>&1 | grep -q 'mirrors\.aliyun\.com'，失败则中断构建，防止用错源装出不一致vendor
真正难的不是换镜像，而是让 composer install 在开发机、测试机、CI、Docker 容器里发出的每一个 HTTP 请求，都命中你写的那个 URL——这要求配置写对、锁文件重生成、所有人不绕过 git 提交的 composer.json。
