Composer 不支持一键切换多个 packagist 镜像源，因其校验阶段禁止 repositories 中存在多个 type=composer 的源；多源管理需靠外部脚本按需设置单一有效源，并严格满足四要素：-g 参数、键名 repo.packagist、值为 composer 类型、URL 以 https:// 开头且结尾带 /。
composer config -g 命令本身不支持“一键切换多个源”，因为 Composer 不允许同时启用多个 packagist.org 类型镜像源——重复声明会触发 Invalid repository type 错误。所谓“多源管理”，本质是外部控制逻辑（如 shell 脚本）在不同场景下动态写入单一有效源，而非 Composer 自身配置叠加。
为什么不能直接在 repositories 里写多个 packagist 镜像
Composer 认为 packagist.org 是唯一元数据源，repositories 数组中若出现两个 {"type": "composer", "url": ".../composer/"}，就会因类型冲突拒绝加载。不是顺序问题，是校验阶段直接失败。
常见错误包括：
- 手动编辑
composer.json加了两段阿里云+腾讯云 URL - 脚本用
composer config --global repos.aliyun ...和repos.tencent ...并存，但没禁用默认源 - 误以为
composer config -g repo.packagist可以设成数组 —— 它只接受单个对象值
真正可行的“多环境切换”靠什么
必须绕过 Composer 的配置层，用外部逻辑控制每次执行时的源地址。关键不是“存多个”，而是“按需选一个”。
实操要点：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 脚本接收参数（如
dev、ci、prod），查表映射到对应 URL - 用
COMPOSER_HOME=/tmp/composer-home-$$临时隔离，避免污染用户级配置 - 强制用
composer -d /path/to/project install启动，确保不读上级 composer.json - 加
--no-plugins防止第三方插件篡改源（比如某些公司自研路由插件） - 每次切换后执行
composer clear-cache，否则旧 DNS 或连接池可能继续发请求到失效地址
验证是否真切换成功，别只看命令回显
composer config -g repo.packagist 输出为空，不代表失败；输出有值，也不代表生效。必须交叉验证三处：
-
composer config -g repo.packagist.url—— 必须是你设的镜像域名，不是packagist.org -
composer diagnose中 “Repo:” 行 —— 显示的 URL 域名要匹配 -
composer show -p | head -3—— 第一行应含mirrors.aliyun.com或对应镜像域名
最容易被跳过的是检查项目根目录下的 composer.json：只要它含有 "repositories" 字段（哪怕只是 {} 或 []），全局配置就完全失效。
别信“一键脚本”，先搞清这四个硬性条件
所有 composer config -g 命令都必须满足四要素，缺一即静默失效：
-
-g参数不能漏，否则只改当前目录 - 键名必须是
repo.packagist（单数repo，不是repos） - 第三参数必须是
composer（表示类型，不是注释，不是可选） - URL 必须以
/结尾，且协议为https://（https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌）
Composer ≥2.2 推荐用 repositories.packagist.org 键名，但旧脚本若仍用 repo.packagist，在部分 CI 环境（如 Docker 官方镜像）下会静默忽略 —— 这不是 bug，是版本兼容性现实。
