全局配置命令composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/必须严格满足三要素：键名repo.packagist（单数）、type值composer、url以https开头且末尾带斜杠，缺一即静默失效。
composer config -g repo.packagist 命令必须写对三要素
90% 的镜像配置失败，不是网络问题，是命令敲错了。这条命令静默失效——不报错、不提示，但 composer config -g repo.packagist 返回空或仍是 https://packagist.org，说明根本没写进去。
-
repo.packagist是唯一合法键名：不能写成repos.packagist（多一个 s）、packagist.org或repositories.packagist -
composer是 type 值，不是注释也不是可选参数：漏掉就 fallback 到官方源，尤其 Composer 2.0+ 会直接忽略 - URL 必须是 HTTPS 且末尾带斜杠：
https://mirrors.aliyun.com/composer/✅，http://...❌，https://mirrors.aliyun.com/composer（少斜杠）❌——后者会导致拼出/composerpackages.json404
验证是否生效，只用这一条命令：composer config -g repo.packagist，输出应为完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。
项目级配置比全局更可靠，尤其适合 CI 和团队协作
全局配置在宝塔、GitHub Actions、Docker 构建中经常失效：CI 流水线用 runner 用户运行，读不到你本地 ~/.composer/config.json；多人协作时，新人拉代码后行为不一致。
- 进项目根目录，运行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g） - 该命令自动向
composer.json写入"repositories"字段，key 固定为"packagist"，不会覆盖已有私有源（前提是原repositories是对象结构） - 如果项目已有
"repositories": []数组形式，别手动覆盖——用命令追加，否则可能误删私有包源 - 改完必须删掉
vendor/和composer.lock，再跑composer install（不是update），否则旧 lock 文件仍指向官方源
换源后还卡在 Resolving dependencies？和镜像无关
镜像只加速元数据拉取和 ZIP 下载，不解决依赖解析慢的问题。composer update 卡几十秒甚至几分钟在 Resolving dependencies 阶段，基本可以确定是 composer.json 写法或本地环境导致的。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- PHP 版本约束太宽，比如
"php": "^7.4 || ^8.0 || ^8.1 || ^8.2"，会让 Composer 尝试大量版本组合 - 大量未锁定的 dev 分支依赖，如
"monolog/monolog": "dev-main"，每次都要重新解析整个分支历史 -
require-dev里塞了太多工具（phpunit、phpstan、psalm 等），尤其当它们之间存在冲突约束时 - 老旧项目用了已废弃的
fxp/composer-asset-plugin，它绕过 Composer 镜像机制，直连 Bower/NPM 源——而这些源在国内根本没镜像
这类问题换再快的镜像也无效，得查 composer.json、收紧版本约束、删掉非必要 dev 包，或升级到现代替代方案（如 npm/yarn 替代 asset 插件）。
推荐镜像源清单及可用性判断方式
别盲目复制网上旧教程里的地址。有些镜像已下线（如 packagist.phpcomposer.com），有些同步延迟高（部分小众镜像数小时不同步）。当前（2026 年 7 月）稳定、同步及时、支持 HTTPS 的主流镜像只有这几个：
- 阿里云：
https://mirrors.aliyun.com/composer/—— 同步频率约 3–5 分钟，国内访问最稳 - 清华大学：
https://mirrors.tuna.tsinghua.edu.cn/composer/—— 教育网优先，公网也可靠 - 腾讯云：
https://mirrors.cloud.tencent.com/composer/—— 近期稳定性提升明显，适合华南用户 - 华为云：
https://repo.huaweicloud.com/repository/php/—— 注意路径结尾无斜杠，但它是合法的（华为云特殊设计）
验证镜像是否可用，不用等 composer install 失败：直接 curl -I https://mirrors.aliyun.com/composer/packages.json，返回 HTTP/2 200 表示服务正常；返回 404 或超时，就换源。
