项目级配置必须写进composer.json才是唯一靠谱做法，因全局配置易导致跨国协作不一致、CI读不到、Git不同步；执行composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不带-g）可安全写入，且repositories必须为对象结构。
项目级配置必须写进 composer.json，而非全局
跨国协作项目里，国外团队可能依赖官方源做发布验证，国内团队却要扛住超时和限速。这时候全局镜像（composer config -g repo.packagist）会破坏一致性——CI 流水线用 runner 用户运行，压根读不到你本地的 ~/.composer/config.json；Git 也同步不了你的个人配置。唯一可靠的做法，是把镜像声明直接写进项目的 composer.json。
进项目根目录，执行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/
注意：不带 -g，命令会自动在 composer.json 顶层写入 "repositories" 字段，并确保 key 是 "packagist"（不是 "aliyun" 或 "packagist.org"）。
- 如果项目已有
"repositories": {}（空对象），该命令安全追加"packagist"子项 - 如果已有
"repositories": []（数组），命令会失败；需先手动改为对象结构再重试 - 切勿手写
"packagist.org": false—— 这会彻底关闭回退路径，镜像临时不可用时composer install直接中断
composer.json 中的 repositories 必须是对象，不能是数组
很多团队误把镜像源当成普通仓库往 "repositories": [] 数组里塞，结果 Composer 不识别 "packagist" 键，仍走官方源。正确结构必须是对象：
"repositories": {
"packagist": {
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/"
}
}
这种写法让 Composer 明确知道：这是对默认 packagist.org 的替代，不是新增一个可选仓库。一旦写成数组形式，哪怕内容完全一样，"packagist" 键也会被忽略。
- 手动编辑时，务必检查 JSON 格式合法（尤其末尾逗号）
- 改完立刻运行
composer validate确认语法无误 - 提交前删掉
vendor/和composer.lock，再跑一次composer install，确保所有包 dist URL 都来自镜像站
换源后仍卡在 Resolving dependencies？这不是镜像问题
镜像只加速元数据拉取（packages.json）和 ZIP 包下载，不参与依赖解析。如果 composer update 卡在 Resolving dependencies 超过 30 秒，说明问题出在本地约束上：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
"php": "^7.4 || ^8.0 || ^8.1 || ^8.2"这类宽泛版本约束会让 Composer 尝试上百种组合 -
"monolog/monolog": "dev-main"这类未锁定的 dev 分支，每次都要重新 fetch 元数据 -
require-dev里堆了phpunit、phpstan、psalm、larastan多个静态分析工具，它们彼此有冲突约束
这类问题换任何镜像都无效。解决方法是收紧 PHP 版本、用 composer require --locked 锁定 dev 分支、或拆分 require-dev 到不同环境配置中。
验证是否真生效，只看这一条命令输出
别信终端没报错就以为成功了。真正有效的验证方式，只有这一条：
composer config repo.packagist
它必须返回完整 JSON 对象，例如：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
- 返回空、
null、或报Key not found→ 配置根本没写进去 - 返回原始字符串如
"https://mirrors.aliyun.com/composer/"（新版行为）→ 缺少composertype 声明，静默 fallback 到官方源 - 返回
{"type": "composer", "url": "https://packagist.org/"}→ 镜像地址被覆盖或未生效
最容易被忽略的是：改完 composer.json 后忘记运行 composer update --lock。否则 composer.lock 里记录的仍是官方源地址，下次 CI 构建时又会慢下来。
