Composer config –global repo 配置全局默认仓库源【进阶】

全局配置 composer 镜像源应使用 composer config –global repos.packagist composer ，而非 repo.packagist.org；后者为伪配置项，仅支持 false 或对象赋值，字符串直接赋值会失败。

全局配置 Composer 默认仓库源，本质是修改 composer.json 的 repositories 字段，但必须用 config --global 命令写入用户级配置，否则不生效。

为什么 config --global repo.packagist.org 不起作用？

因为 Packagist 官方源不是普通仓库类型，它被硬编码为默认行为；repo.packagist.org 是个伪配置项，仅用于禁用（设为 false）或切换镜像（设为 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}），不能直接用字符串赋值。

• 错误写法：composer config --global repo.packagist.org https://mirrors.tuna.tsinghua.edu.cn/composer/ → 会报错或静默失败
• 正确写法：composer config --global repos.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/
• 若要彻底禁用官方源（强制走镜像），需额外加：composer config --global repo.packagist false

repos.packagist 和 repositories 数组的区别

前者是全局快捷 alias，后者是项目级完整定义。全局 repos.packagist 会被自动合并进每个项目的 repositories，优先级低于项目中显式声明的同名仓库。

• repos.packagist 只能覆盖 Packagist 类型源，无法添加其他类型（如 vcs、package）
• 想加私有 git 仓库？必须在项目 composer.json 里写 "repositories": [{"type": "vcs", "url": "git@xxx"}]
• 全局配置不影响 packagist.org 的元数据缓存逻辑，只是替换请求地址

镜像源配置后仍访问 packagist.org 的常见原因

不是配置没生效，而是 Composer 在某些场景下会绕过镜像——比如查询 packages.json 时发现本地缓存过期，又没权限写缓存目录，就会 fallback 到官方源。

• 检查是否启用了 COMPOSER_DISABLE_TlspROXY 或代理干扰 HTTPS 请求
• 运行 composer clear-cache 后再 composer show -p，确认输出的 URL 是镜像地址
• 执行 composer diagnose，留意 “The configured repository (packagist) is not a valid Packagist repository” 类提示
• 某些旧版 Composer（repos.packagist 支持不全，建议升级到 2.x

真正生效的全局镜像配置，依赖三者一致：命令写法正确、Composer 版本支持、网络环境不拦截重定向。漏掉任意一环，都会在 install/update 时悄悄连回 packagist.org。