全局配置命令composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/必须严格满足三要素：键名repo.packagist（非repos）、composer为type值、url须https且末尾带/，缺一即静默失效；验证需composer config -g repo.packagist输出完整json，项目级配置优先级更高且更可靠。
composer config -g repo.packagist 命令必须写对三要素
配不生效，90% 是这条命令敲错了，不是网络问题。它必须同时满足三个硬性条件：
-
repo.packagist不能写成repos.packagist（多一个s就完全无效，也不报错） - 中间的
composer是type值，不能省；漏掉它，Composer 2.x 会静默 fallback 到官方源 - URL 必须是 HTTPS 且末尾带
/，例如https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠直接 404）
验证是否写入成功：运行 composer config -g repo.packagist，输出应为完整 JSON 对象，如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。如果返回空、null 或报错，说明根本没写进去。
项目级配置比全局更可靠，尤其在 CI/CD 和团队协作中
全局配置写在 /root/.composer/config.json，但它只对以 root 用户身份执行的 composer 命令有效。而宝塔面板、Docker 构建或 GitHub Actions 通常以非 root 用户（如 www、runner）运行，根本读不到 root 的配置。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 进项目根目录后运行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/ - 该命令自动向
composer.json的repositories字段追加packagist条目，不覆盖已有私有源 - 如果项目已有
"repositories": {}，别手动编辑 JSON——格式错一个逗号就导致composer install报错 - 确认生效后，
composer.json中应出现类似："packagist": {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
换源后仍卡在 Downloading？先清缓存再重装
镜像只加速下载，但旧缓存里存着 packagist.org 的元数据，Composer 会优先读缓存并尝试从旧地址校验，结果就是卡在 DNS 或 TLS 握手——不是没走镜像，是根本没发请求过去。
- 必须执行：
composer clear-cache - 删掉
vendor/和composer.lock - 再跑：
composer install --no-cache（禁用缓存强制走新源） - 别试图保留旧
composer.lock——它记录的是旧源的包哈希，和镜像返回的元数据不兼容，必然报hash does not match
验证是否真走镜像，不能只看 config 输出
光跑 composer config -g repo.packagist 显示 URL 没用，得看到网络请求实际打到镜像域名才算数。
- 实测命令：
composer show monolog/monolog -vvv 2>&1 | grep "Downloading" - 日志里必须出现
mirrors.aliyun.com或mirrors.cloud.tencent.com等镜像域名 - 如果看到
https://packagist.org或repo.packagist.org，说明 fallback 触发了，配置没起作用
复杂点在于：Composer 不校验镜像 URL 是否可达，只要语法合法就接受；而一旦 fallback 发生，整个过程静默无提示——你得盯着日志里的域名才能确认真实流向。
