那些被忽略的Composer镜像配置细节-composer-PHP中文网

composer config -g repo.packagist 不生效是因为未同时满足四个硬性条件：键名必须为 repo.packagist（非 repos.packagist 等）、中间必须显式指定 type 值 composer、url 必须 https 且末尾带 /、必须加 -g 参数；任一缺失即静默回退官方源，且验证需输出完整 json 对象。

那些被忽略的composer镜像配置细节

配了镜像却还是连 packagist.org，不是网络问题，是配置被 Composer 静默忽略——它不报错，只当没这回事。

为什么 `composer config -g repo.packagist` 总是不生效

这条命令必须同时满足四个硬性条件，漏一个就回退到官方源，且无任何提示：

repo.packagist 键名不能写成 repos.packagist、packagist 或 packagist.org
中间的 composer 是 type 值，不是可选参数：写成 composer config -g repo.packagist https://mirrors.aliyun.com/composer/ 就失效
URL 必须以 / 结尾：https://mirrors.aliyun.com/composer/ ✅，https://mirrors.aliyun.com/composer ❌（会拼出 /composerpackages.json 导致 404）
必须用 -g 参数；不加就是改当前项目，不是全局

验证是否真写进去了，只看这一行输出：composer config -g repo.packagist。返回 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 才算成功；空、null、或报 Key does not exist，说明根本没写对。

项目级 `repositories` 字段一出现就屏蔽全局镜像

只要 composer.json 顶层有 "repositories" 字段（哪怕只是 "repositories": []），全局配置立刻失效——不是“优先级低”，而是直接跳过。

CI 流水线脚本自动生成空数组 "repositories": []，构建时就会直连 packagist.org
composer create-project 拉的模板常自带 repositories，你刚配好的全局镜像压根没机会触发
执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g）会全量覆盖整个 repositories 字段，把你原有的私有 Git 源清空

安全做法是手动编辑 composer.json，确保 "repositories" 是数组，首位放 {"packagist.org": false}，第二位才是镜像源，其他自定义源保留在同一数组里。

Discussion Composer

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

下载

`{"packagist.org": false}` 必须独立、靠前、拼写精确

这不是可选项，而是硬性兜底规则：没有它，Composer 会在查完所有镜像后自动追加官方源——在国内基本等于卡死。

必须是 repositories 数组里的一个独立对象，不能塞进别的对象里（比如不能写在某个私有源对象内部）
必须放在数组第一个位置；靠后会被后续条目影响语义（Composer 解析顺序依赖位置）
键名必须是 "packagist.org"，写成 "packagist"、"packagist.com" 或 "packagist.org": true 都无效
值必须是布尔 false，不是 null、字符串 "false" 或数字 0