Composer如何配置全局和局部中文镜像（差异对比）-composer-PHP中文网

全局镜像配置仅认composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，缺-g、错键名repos.packagist、少composer类型、url缺末尾/或权限错误均导致静默失效；项目级repositories字段会完全覆盖全局配置；验证必须用-vvv日志确认真实请求域名。

composer如何配置全局和局部中文镜像（差异对比）

全局镜像配置只认 `composer config -g repo.packagist`

全局镜像不是“随便改个配置就生效”，它只响应一条命令：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。漏掉任意一环都会静默失败：

-g 缺失 → 写进当前项目 composer.json，对其他项目无效
repo.packagist 写成 repos.packagist 或 repository → 字段被忽略，composer config -g repo.packagist 返回空或 null
缺 composer 这个 type 值 → Composer 2.0+ 直接 fallback 到官方源，等于白配
URL 少末尾 / → 请求路径拼成 https://mirrors.aliyun.com/composerpackages.json，404 报错

Windows 用户改完需重启终端才能读到新配置；Linux/macOS 若用 sudo composer config -g，配置会写进 /root/.composer/config.json，普通用户运行时根本加载不到。

项目级镜像会完全覆盖全局配置

只要项目根目录的 composer.json 里有 "repositories" 字段，无论内容是否为空、是否含有效源，全局镜像立即失效——Composer 不合并，只替换。

Discussion Composer

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

下载

常见误判：执行 composer config -g repo.packagist 看到阿里云地址，但 composer install 仍连 packagist.org → 检查 composer.json 是否存在 "repositories": {} 或 "packagist.org": false
composer config --list 和 composer config --list --global 输出不一致，就是项目级接管了
项目级命令是 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉 -g），它会往 composer.json 顶层写入 "repositories" 对象，但若原字段是数组，就会整个覆盖，不是合并

验证镜像是否真在用，不能只看配置输出

composer config -g repo.packagist 只告诉你“写了什么”，不代表“正在用”。最可靠方式是触发真实网络请求：

先清缓存：composer clear-cache
跑一次带详细日志的安装：composer require monolog/monolog -vvv
在输出中搜索 Downloading，确认出现的是 https://mirrors.aliyun.com/composer/packages.json，而不是 https://packagist.org/packages.json 或拼错的路径
composer diagnose 的 “Repo” 行显示地址只是配置检查，不验证实际请求行为

私有包 + 公共镜像混合时，必须用项目级 `repositories` 数组

全局 repo.packagist 只代理 packagist.org 元数据，对私有源完全无效。混用场景下，repositories 必须是索引数组，顺序即查找顺序：

私有源放第一位：{"type": "composer", "url": "https://pkgs.internal/artifactory/api/composer/internal/"}（注意末尾 /）
公共镜像放第二位：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
兜底可选：{"packagist": true}（不是 URL，只查元数据）
错误写法："repositories": { "internal": { ... }, "aliyun": { ... } } → Composer 只读第一个键，其余静默丢弃

项目级配置虽麻烦一点，但可控、可 Git 跟踪、可 CI 复现；全局配置看着省事，却最容易在协作和部署中突然失效——尤其当你忘了某个项目里早有一行 "repositories": {} 的时候。