详解Composer局部项目镜像源配置-composer-PHP中文网

项目级镜像配置必须在composer.json的repositories字段中严格按数组格式声明，首项为{"packagist.org": false}，次项为镜像源，且需清理vendor和composer.lock后执行composer install。

详解composer局部项目镜像源配置

项目级镜像配置不是“改个地址就完事”，它必须写进 composer.json 的 repositories 字段，且结构、顺序、清理动作三者缺一不可；否则 composer install 仍会连 packagist.org，卡在 “Loading composer repositories”。

为什么 `composer config repo.packagist` 命令不加 `-g` 却没写进 `composer.json`

这条命令只在当前目录有合法 composer.json 时才生效，且对 repositories 字段的格式极其敏感：

如果原 composer.json 中 "repositories" 是数组（[]），命令直接报错退出，不会写入任何内容
如果 "repositories" 是空对象（{}），命令会安全合并，添加 "packagist" 子项
如果 "repositories" 字段根本不存在，命令会新建该字段并设为 {"packagist": {...}}
手动写成 "repositories": {"packagist.org": false, "packagist": {...}} 是无效的——Composer 2.2+ 要求 repositories 必须是数组，对象形式会被静默忽略

`repositories` 数组必须以 `{"packagist.org": false}` 开头

这是最关键的硬性规则：即使你配了阿里云镜像，只要没显式禁用官方源，Composer 仍会 fallback 到 packagist.org 请求元数据，导致超时或 404。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

正确结构是："repositories": [{"packagist.org": false}, {"packagist": {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}}]
不能把 "packagist.org": false 和镜像配置合并成一个对象，也不能把它放在第二项之后
别写 "packagist.org": true 或 "packagist.org": null，只有 false 才代表禁用
如果已有私有源（如 GitLab 包），应追加在镜像配置之后，保持数组顺序

配完不删 `vendor` 和 `composer.lock` 就运行 `composer install` 必然失败

composer.lock 文件里存的是每个包的原始下载地址（例如 https://api.github.com/ 或 https://packagist.org/），镜像只影响元数据（packages.json）拉取，不影响 lock 文件里的 dist URL。

必须执行：rm -rf vendor composer.lock
再运行：composer install（不是 update）——只有 install 会重新基于当前 composer.json + 镜像配置生成新 lock
若跳过清理，你会看到 file could not be downloaded 或反复尝试连接 packagist.org
验证是否真走镜像：加 -vvv 运行 composer install -vvv，搜索日志中是否出现 mirrors.aliyun.com/composer/packages.json

验证是否生效不能只看 `composer config repo.packagist` 输出

这条命令只读取 composer.json 里已写的内容，不反映实际请求行为。真正有效的验证方式是观察网络请求路径：

运行：composer install -vvv 2>&1 | grep -i 'Downloading\|packages.json'
成功标志：日志中出现类似 Downloading https://mirrors.aliyun.com/composer/packages.json
失败标志：出现 https://packagist.org/packages.json 或 https://repo.packagist.org/packages.json
额外确认：composer diagnose 输出中 Repo packagist.org: 行应显示你的镜像 URL，而非默认地址

最常被忽略的一点：项目级配置优先级永远高于全局配置，哪怕你本地 composer config -g 配好了，只要项目 composer.json 里有 repositories 字段（哪怕只是空数组），全局镜像就完全不参与解析——这不是 bug，是 Composer 的硬编码行为。