Composer不支持按环境自动切换镜像源，必须通过项目级repositories配置或运行时脚本注入实现环境隔离；全局config --global repo.packagist为单值静态配置，无法满足多环境需求。
不支持“按环境自动切换镜像源”这种原生能力。Composer 本身没有 env、stage 或 --env=prod 这类内置机制来动态绑定镜像地址。所谓“多环境镜像”，必须靠外部控制——要么用项目级 composer.json 硬编码，要么靠脚本注入，不能依赖 Composer 自己识别环境。
为什么 composer config --global repo.packagist 无法满足环境隔离
全局配置是单值、静态、用户级的：repo.packagist 字段只能存一个 URL，写第二次就覆盖第一次；它对所有项目生效，无法区分 dev/ci/prod 场景。CI 流水线里如果多个 job 并发执行，还可能因 COMPOSER_HOME 冲突导致镜像错乱。
- 执行
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/后，再跑composer config -g repo.packagist composer https://packagist.org/，前者立刻失效 - CI 中若未清理
~/.composer/config.json，上个 job 设的镜像会污染下一个 job - 本地开发切到腾讯云，但测试环境必须走华为云——全局配置做不到并存或条件切换
真正可行的“环境级镜像”只有两种落地方式
一种是项目内固化（推荐），一种是运行时注入（适合 CI）。两者都绕开全局配置，避免污染。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
项目级配置（提交进 Git）：在每个项目的
composer.json根节点加"repositories"数组，例如：{ "repositories": [{ "type": "composer", "url": "https://mirrors.tencent.com/composer/" }], "packagist.org": false }这样 dev 分支用阿里云、prod 分支用华为云，靠分支策略自然隔离 -
脚本动态注入（CI 场景）：用 shell 脚本接收
ENV=ci参数，查表得 URL，再通过COMPOSER_HOME=/tmp/composer-home-$$+composer -d /path/to/project install启动，完全不碰用户家目录
repositories 数组不是“多镜像 fallback”，而是“顺序匹配”
很多人误以为配了两个源就能自动容灾，其实 Composer 只按数组顺序逐个查包：第一个源返回 404 才试第二个，但遇到超时或 502 会卡满 30 秒才跳。所以真要兼顾速度和兜底，必须显式禁用默认源，并把国内镜像放前面、官方源放最后：
- 必须写
"packagist.org": false在composer.json根节点，否则你配的镜像只是“额外源”，官方源仍优先 - URL 必须以
https://开头、结尾带/，比如https://repo.huaweicloud.com/repository/php/，少斜杠就会拼出/phppackages.json导致 404 - 不要手动写
"packagist": true来兜底元数据——那是 Composer 2.2+ 自动补的，手写反而可能破坏结构
最易被忽略的一点：项目根目录下只要存在 composer.json 且含 "repositories" 字段（哪怕为空对象），全局 repo.packagist 配置就彻底失效。这不是 bug，是设计——优先级永远是：项目级 > 用户级 > 全局。所以别指望改完 config -g 就能一劳永逸。
