单纯换 Composer 镜像源对 Docker 构建速度提升非常有限，甚至可能没效果——因容器不读取宿主机配置，composer install 仍直连 packagist.org 或 github.com；镜像仅加速元数据（packages.json），不加速 zip 包下载，实际 dist 文件仍从 github.com 下载，而国内访问 GitHub 极不稳定，DNS 解析慢、TLS 握手超时、连接重置频繁。
单纯换 Composer 镜像源对 Docker 构建速度提升非常有限，甚至可能没效果——因为容器内默认不读取宿主机配置，composer install 依然直连 packagist.org 或 github.com，卡在 Downloading https://api.github.com/ 是常态。
为什么 Docker 构建里配了镜像却没提速
镜像源只加速元数据（packages.json），不加速 zip 包下载。实际 dist 文件仍从 github.com 或 codeload.github.com 下载，而国内访问 GitHub 极不稳定：DNS 解析慢、TLS 握手超时、连接重置频繁。日志里反复出现 Downloading https://api.github.com/ 或 https://codeload.github.com/ → 镜像根本没起作用。
-
composer config -g写的配置在构建阶段完全不可见，Docker 容器是全新上下文 - 即使
composer config -g repo.packagist显示正确，速度也毫无改善——镜像不管 dist 包路径 - 构建过程不会自动继承宿主机的
~/.composer/config.json
Dockerfile 中必须显式声明镜像源
推荐做法是直接在 RUN 指令中用参数指定，语义清晰、可复现、不依赖全局状态：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
RUN composer install --repository=https://mirrors.aliyun.com/composer/
- 该参数优先级最高，覆盖全局和项目级配置
- 避免使用
--repository-url（旧版兼容写法），新版 Composer 推荐--repository - 若需同时指定多个源（如私有包 + 镜像），应改用
--repository多次叠加，而非混用 - 不要在
composer.json里硬编码repositories后再copy进镜像——容易因缓存导致旧 lock 文件沿用原始 dist URL
配合分层缓存与参数优化才真正有效
仅加镜像参数还不够，得让缓存命中率拉满：
-
composer install前确保composer.lock已COPY进来，且放在composer.json之后——否则缓存会失效 - 避免把
vendor/目录COPY进来，它应该由composer install生成 - 加
--no-interaction --no-scripts --prefer-dist减少非必要开销 - 如果项目依赖大量私有包，建议提前用
composer config在构建阶段动态写入repositories，而不是靠composer.json静态定义
验证是否真走镜像：看日志第一行 GET 请求
构建时加 -vvv 参数，盯住最开头的请求地址：
- ✅ 正确：日志首行是
GET https://mirrors.aliyun.com/composer/packages.json - ❌ 错误：仍是
GET https://packagist.org/packages.json或GET https://api.github.com/ - 注意：即使元数据加载飞快（
mirrors.aliyun.com/composer/），某个包卡住 30 秒以上 → 八成是 GitHub 直连问题，镜像救不了 - 别信
composer config -g输出，它在容器里压根不存在；验证必须在构建日志里找真实 HTTP 请求
最容易被忽略的是：镜像只解决元数据瓶颈，而 Docker 构建真正的卡点往往在 GitHub 的 dist 包下载环节——那部分没法靠镜像绕过，得靠 GITHUB_TOKEN 或企业内网代理兜底。
