composer diagnose不检查镜像配置是否生效，它只验证composer自身启动能力；真正检验镜像配置需运行composer config -g repo.packagist看是否输出完整json，且用curl -fssl --max-time 3加jq验证p2接口可用性。
composer diagnose 不检查镜像配置是否生效
运行 composer diagnose 完全不验证你配的中文镜像有没有被读取、URL 是否拼错、repo.packagist 字段是否存在——它只管 Composer 自身能否启动。哪怕你写成 repos.packagist（多一个 s），或 URL 少了结尾斜杠（https://mirrors.aliyun.com/composer ❌），diagnose 仍显示 OK，但后续 install 必然卡在 Resolving packages... 或直接 404。
真正能暴露镜像配置问题的命令只有两个：
-
composer config -g repo.packagist—— 输出必须是完整 JSON，形如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；空、null或报错说明没写进去 -
composer config --list | grep repositories—— 查看当前上下文实际生效的源，确认不是项目级composer.json里残留的旧配置覆盖了全局设置
镜像健康检查必须模拟真实请求路径
只用 curl -I https://mirrors.ustc.edu.cn/composer/ 测状态码是无效的。Composer 实际请求的是 /p2/{vendor}/{package}.json 这类元数据接口，首页 200 ≠ p2 接口可用。
正确做法是：
- 用
curl -fsSL --max-time 3 https://mirrors.aliyun.com/composer/p2/monolog/monolog.json发起真实请求 - 配合
jq -e 'has("packages")'验证响应体结构，而非仅看 HTTP 状态码 - 超时设为 3 秒（
--max-time 3），避免单个镜像拖慢整个 failover 流程 - 必须带
-f（失败时不输出 body）和-s（静默模式），否则jq会因 HTML 错误页崩溃
failover 依赖 repositories 顺序 + packagist.org 禁用
Composer 原生不支持自动主备切换，所谓“故障转移”靠的是手动控制 repositories 数组顺序和显式关闭官方源。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
关键约束有三：
-
"packagist.org": false必须是布尔值false，不能加引号写成字符串"false" - 所有镜像条目必须声明
"type": "composer"，且url以/结尾（否则 Composer 会错误拼出/p2//xxx.json） - 多个镜像按优先级从上到下排列，Composer 会逐个尝试
packages.json，任一成功即停止，失败则继续下一个
漏掉任意一条，比如混用 type: "packagist" 和 type: "composer"，就会导致部分包仍走境外源。
CI/CD 中镜像配置常被用户上下文覆盖
在 Docker 或 GitHub Actions 里执行 composer config -g，结果却没生效，大概率是因为：配置写进了 root 用户的 ~/.composer/config.json，而实际运行 composer install 的是 runner 或 www 用户，它读的是自己的家目录。
安全做法是：
- CI 脚本开头明确设置
export COMPOSER_HOME=$HOME/.composer，并确保该目录可写 - 改用项目级配置：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/，然后提交composer.json到 Git - 避免
sudo composer config -g—— 它把配置写进 root，对非 root 用户完全不可见
镜像配置本身很简单，难的是让配置落到真正执行命令的那个用户身上。这点在容器和自动化流程里最容易被忽略。
