全局配置 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。
