composer config -g repo.packagist 总不生效是因为必须同时满足三个硬性条件：键名必须为单数 repo.packagist、第二个参数必须显式写 composer（type 值）、url 必须 https 且末尾带 /；任一不符即静默回退官方源，验证需输出完整 json 对象。
直接配镜像源就能解决 composer install 卡在 Loading composer repositories 的问题，但 90% 的失败不是网络差，而是命令写错三个硬性条件：键名必须是 repo.packagist（不能多 s）、composer 是必须显式写出的 type 值、URL 必须 HTTPS 且末尾带 /。
为什么 composer config -g repo.packagist 总不生效
Composer 2.x 遇到配置错误会静默 fallback 到 https://packagist.org，不报错也不提示。常见失效原因：
-
repo.packagist写成repos.packagist或packagist—— 键名错，配置被完全忽略 - 漏掉中间的
composer，比如执行composer config -g repo.packagist https://mirrors.aliyun.com/composer/—— 缺type，自动退回到官方源 - URL 少了末尾斜杠：
https://mirrors.aliyun.com/composer❌ 会导致请求路径变成/composerpackages.json，404 - 用了 HTTP 协议：
http://被 Composer 2.0+ 拦截，必须用 HTTPS
验证是否真写入：运行 composer config -g repo.packagist，输出必须是完整 JSON，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、报 Key does not exist，都说明没配成功。
项目级配置比全局更可靠，尤其在 CI/CD 和团队协作中
全局配置写在 ~/.composer/config.json，但 GitHub Actions 用 runner 用户、宝塔用 www 用户、Docker 容器常以非登录用户运行——它们根本读不到你的配置。
进项目根目录（含 composer.json），执行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
这条命令会：
- 自动识别
composer.json中已有的repositories结构（对象 or 数组） - 安全追加
"packagist"条目，不破坏私有源 - 提交后，所有协作者 clone 项目即可继承，无需各自配置
注意：别手动写 "packagist.org": false，这会导致 php、ext-json 等基础约束校验失败。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
怎么确认镜像真正在用，而不是“设了但没走”
composer config -g repo.packagist 只显示“设了什么”，不反映“实际发了什么请求”。真正验证得看日志里的真实下载地址：
执行：
composer show -v | head -n 5
观察输出中的 Downloading 行：
- 含
packagist.org→ 镜像未生效，或被项目repositories覆盖 - 含
mirrors.aliyun.com、mirrors.tuna.tsinghua.edu.cn等 → 镜像正常
更彻底验证：先 composer clear-cache，删掉 vendor/ 和 composer.lock，再跑 composer install -vvv，全程观察日志里第一个 GET 请求地址。
2026 年 8 月实测仍可用的主流镜像源
截至今天，只有以下三个镜像全量同步、HTTPS 强制、延迟稳定（通常 ≤5 分钟）：
- 阿里云：
https://mirrors.aliyun.com/composer/—— 通用性最强，华南/华东/华北访问无感延迟 - 清华源：
https://mirrors.tuna.tsinghua.edu.cn/composer/—— 教育网和北方极快，南方偶有 DNS 解析慢 - 华为云：
https://mirrors.huaweicloud.com/repository/php/—— 同步节奏稳，适合对稳定性要求高的 CI 流水线
已失效源（别再试）：https://packagist.phpcomposer.com（频繁 502）、https://packagist.laravel-china.org（已停止维护）。
换源后仍卡住，大概率是旧 composer.lock 还记着官方源地址，或者缓存没清干净——这两个点最容易被跳过。
