真正可靠的做法只有两种：全局 composer config -g repo.packagist 或项目级 composer config repo.packagist；其余如 repositories 数组多镜像、环境变量 COMPOSER_REPO_PACKAGIST、手动改 config.json 等均为特定场景下的权宜之计，且易出错。
没有“冷门但好用”的 Composer 镜像配置方法——只有被误用、误传、或在特定场景下被迫使用的非标准写法。所有看似“另类”的配置，要么违反 Composer 设计逻辑，要么掩盖了真实问题，最终都会在 CI/CD、多用户环境或依赖更新时暴露。真正可靠的做法就两种：全局 composer config -g repo.packagist，或项目级 composer config repo.packagist。其余都是权宜之计。
为什么 repositories 数组里塞多个镜像源不 work
很多人以为在 composer.json 的 repositories 里写两个阿里云地址就能自动 fallback，实际根本不会触发重试。
- Composer 只按顺序查每个源的
packages.json，合并元数据；下载 ZIP 包时，只从第一个声明了该包完整版本信息的源拉取 - 遇到 502、超时、DNS 失败，直接报错退出，不会查下一个；只有明确返回 404（包不存在）才继续往后找
- 写成
"repositories": [{"url": "https://a.com"}, {"url": "https://b.com"}]，结果是：a 挂了 → 整个 install 失败，b 根本没机会被访问 - 更危险的是混写
"type": "vcs"或漏掉"type": "composer"，会导致Invalid repository type错误
用 COMPOSER_REPO_PACKAGIST 环境变量临时覆盖
这不是冷门技巧，而是 CI/CD 和容器化部署中最干净、最可复现的方案，比改配置文件靠谱得多。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 它绕过
~/.composer/config.json和composer.json的优先级干扰，直接注入运行时配置 - 命令示例：
COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/ composer install - 注意：
COMPOSER_REPO_PACKAGIST是唯一被 Composer 官方文档承认的环境变量镜像开关，其他如COMPOSER_HOME改路径容易导致缓存错位 - 在 GitHub Actions 或 GitLab CI 中，推荐写成
env: { COMPOSER_REPO_PACKAGIST: "https://mirrors.aliyun.com/composer/" }，避免 shell 解析问题
手动编辑 config.json 却总失败的原因
直接改 ~/.composer/config.json 看似自由，但极易出错，且错误静默无提示。
- 键名必须是
repo.packagist（单数，不是repos或packagist.org），值必须是完整对象：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 漏掉
"type": "composer"字段？Composer 会忽略整条配置，fallback 到官方源，且不报错 - URL 少了末尾
/？请求变成https://mirrors.aliyun.com/composerpackages.json→ 404 → fallback - Windows 用户常把配置写进
C:\Users\用户名\AppData\Roaming\Composer\config.json，但 PHP 进程实际读的是%COMPOSER_HOME%指向的路径，二者不一致就失效
内网地址和 HTTP 镜像的适用边界
阿里云 ECS 内网地址 http://mirrors.cloud.aliyuncs.com/composer/ 确实快，但它不是通用替代方案。
- 仅限阿里云 VPC 内网访问，本地开发机、腾讯云服务器、Docker Desktop 默认网络均无法解析或连接
- HTTP 地址在 Composer 2.2+ 默认被拒绝，必须显式设置
COMPOSER_DISABLE_TLS=true才能启用（不推荐） - 华为云镜像
https://mirrors.huaweicloud.com/repository/php/路径末尾不带/，但 Composer 会自动补全；不过其同步延迟略高，新发布的包可能要等 10–30 分钟才可见 - 清华 TUNA 镜像支持
--repository-url临时切换，但不能用于create-project流程（该命令不接受此参数）
真正容易被忽略的点：换源之后，composer.lock 文件里的 dist.url 仍指向旧源，导致 hash 校验失败。删 vendor/ 和 composer.lock 再 install，不是“多此一举”，是强制重建信任链的必要动作。
