Composer镜像配置不走composer.json，因它只读取全局或项目级配置；直接在composer.json写repositories虽可临时覆盖，但易被update清空且不支持高级控制，正确方式是用composer config -g或项目级config命令配置。
为什么composer.json里写镜像地址不管用
因为 Composer 的镜像配置不走 composer.json，它只读取全局或项目级的配置文件。直接在 composer.json 里加 "repositories" 字段虽然能临时覆盖 packagist.org，但容易被 composer update 清掉，也不支持认证、缓存策略等高级控制。
真正生效的方式是改 Composer 的配置源，分两种场景：
- 全局生效（推荐）：运行
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 项目级生效（适合 CI 或多环境隔离）：在项目根目录执行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/，会写入composer.json的config→repositories区域，但注意该写法仅对当前项目有效，且需提交到 Git
composer config 和 composer create-project 配合时的坑
如果用 composer create-project 初始化新项目，默认仍走官方源，除非提前设好全局镜像或显式传参。常见错误是以为“已经配过镜像”，结果新项目第一次 install 还是慢得像在爬行。
安全做法是：
- 初始化前确认镜像已全局设置：
composer config -g repo.packagist应返回阿里云或腾讯云镜像地址 - 若需临时指定镜像创建项目，加
--repository-url参数：composer create-project laravel/laravel myapp --repository-url=https://mirrors.aliyun.com/composer/ - 避免混用：不要同时在全局配置和
composer.json里定义repo.packagist，优先级混乱会导致行为不可预测
多个开发节点同步镜像配置的实操要点
统一配置 ≠ 手动在每台机器上敲一遍命令。重点是让镜像设置可版本化、可复现、不依赖人工操作。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
建议方案：
- 用脚本固化配置：写一个
setup-composer.sh，内容包含composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/和composer config -g github-oauth.github.com "xxx"（如有私有包） - CI 环境中，把镜像配置放在
.gitlab-ci.yml或GitHub Actions的 setup 步骤里，避免每次拉取都重装 - 团队内部共享一份
composer-global-config.json，通过composer config -g --merge导入，比逐条config命令更易维护 - 注意 PHP 版本差异：Composer 2.2+ 支持
https://packagist.phpcomposer.com已停用，必须用阿里云、腾讯云或华为云等现行镜像
镜像失效或 404 报错时怎么快速定位
报错如 Could not fetch https://mirrors.aliyun.com/composer/p2/monolog/monolog.json 或 Repository could not be processed，通常不是网络问题，而是镜像本身未同步或路径变更。
排查顺序：
- 先验证镜像可用性：
curl -I https://mirrors.aliyun.com/composer/，看是否返回 200；若返回 301 或 404，说明镜像域名已弃用（例如旧版https://packagist.phpcomposer.com） - 检查 Composer 版本：
composer --version，Composer 2.5+ 默认启用https://packagist.org的代理机制，部分镜像站未适配新协议，导致 metadata 请求失败 - 临时切回官方源测试：
composer config -g repo.packagist composer https://packagist.org，若正常则确认是镜像同步延迟或配置错误 - 查看真实请求日志：
composer install -vvv会打印完整 URL，复制出来用curl直接测，排除 DNS 或中间代理干扰
镜像配置看似简单，但不同 Composer 版本对 repo.packagist 的解析逻辑有细微差别，尤其在混合使用私有仓库和镜像时，repositories 数组顺序和 type 字段稍有偏差就会跳过镜像直接连官方源。
