composer 2.x 和 1.x 镜像配置键名不同：2.x 必须用 repo.packagist，1.x 只认 packagist；混用会导致静默失效，需按版本分别配置，推荐统一升级至 2.x 或使用项目级 repositories 配置确保兼容。
Composer 2.x 和 1.x 的镜像配置键名不同
Composer 2.x 必须用 repo.packagist，而 1.x 只认 packagist（不带 repo. 前缀）。混用会导致配置静默失效——比如你在 Composer 2.2 下运行 composer config -g packagist composer https://mirrors.aliyun.com/composer/，它会写进全局配置，但实际不被 2.x 读取；反过来，用 repo.packagist 配给 1.x 则直接报错或忽略。
验证方法很简单：分别执行 composer --version 看当前版本，再运行对应命令：
- Composer 2.x：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - Composer 1.x：
composer config -g packagist composer https://mirrors.aliyun.com/composer/
别指望一条命令通吃。如果你机器上同时装了两个版本（比如通过 composer1 / composer2 别名调用），就得各自配一次。
全局配置无法跨用户生效，多版本常伴随多用户场景
很多团队用 Docker 或 CI runner 用户跑 Composer，而开发者本地用自己账户配的 -g 配置对 runner 完全不可见。更麻烦的是，Composer 1.x 和 2.x 的全局配置文件路径可能不同（~/.composer/config.json vs ~/.config/composer/config.json），尤其在 macOS 或 Windows WSL 下容易错位。
实操建议：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先确认当前 shell 下
composer命令指向哪个二进制：运行which composer和composer --version - 查清它的配置文件位置：
composer config --list --global输出里会显示 “Global Config” 路径 - 如果要用同一套镜像，最稳妥是统一升级到 Composer 2.x（官方已停止维护 1.x），避免双版本维护成本
项目级配置能绕过版本和用户差异
只要项目根目录下有 composer.json，无论你用 composer1 还是 composer2，也无论谁执行命令，只要 repositories 字段写对，就能强制走国内镜像。这是多版本共存时最可控的做法。
注意两点：
-
"repositories"必须是顶层字段，且 key 固定为"packagist"（不是"aliyun"或其他别名），值是一个对象：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 如果项目已有
"repositories"数组（比如含私有包源），别手动覆盖——用composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g）自动追加，否则会丢掉原有源
换源后 Resolving dependencies 仍卡住？和镜像无关
镜像只加速元数据拉取（即 Loading composer repositories 阶段），不影响依赖解析逻辑。如果你发现 composer update 卡在 Resolving dependencies 几十秒以上，大概率是 composer.json 本身的问题：
- PHP 版本约束太宽，例如
"php": "^7.4 || ^8.0 || ^8.1 || ^8.2"，会让解析器穷举组合 - 大量未锁定的 dev 分支依赖，如
"monolog/monolog": "dev-main" - require-dev 里堆了 phpunit、psalm、phpstan、infection 等多个重型工具，相互冲突
这时候换镜像没用。先简化 composer.json，锁定关键依赖版本，再逐步排查。
