Composer镜像配置静默失效的主因是：键名必须为单数repo.packagist、type值必填composer、URL须以/结尾且为HTTPS、必须加-g参数，四者缺一即退回packagist.org；项目级repositories字段会完全屏蔽全局配置；未执行clear-cache则仍读旧缓存。
配了中文镜像却还是直连 packagist.org，不是网络问题，也不是镜像宕机，而是配置根本没生效——Composer 不报错、不提示、不 fallback，写错一个字符就安静退回官方源。
为什么 composer config -g repo.packagist 总是静默失败
这条命令在 Composer 2.2+ 中已处于兼容性支持边缘，实际生效需同时满足四个硬条件，缺一即废：
-
repo.packagist必须是单数、全小写，写成repos.packagist或repositories.packagist.org（新版推荐键名）以外的任何变体，都会被忽略 - 第三个参数
composer是type值，不是注释——漏掉它，配置存进去了，但 Composer 不认 -
url必须以/结尾，例如https://mirrors.aliyun.com/composer/✅，少斜杠会拼出/composerpackages.json导致 404 - 必须带
-g，否则只改当前目录下的composer.json，换个项目就失效
验证是否真写入：composer config -g repo.packagist 输出必须是完整 JSON，如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；空、null 或报错，说明压根没落盘。
composer.json 里的 repositories 字段会彻底屏蔽全局配置
只要项目根目录存在 "repositories" 字段，无论内容是空数组 []、空对象 {}，还是只写了 {"packagist.org": false}，全局镜像配置就完全失效——Composer 的优先级规则是“项目级 > 全局”，没有协商，没有兜底。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 检查方式：
composer config repositories，如果输出里还含https://repo.packagist.org，说明项目配置正在接管 - 临时禁用（慎用）：
composer config --unset repositories - 安全追加（推荐）：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不带-g），它会自动 merge 到composer.json的repositories对象中，不覆盖已有私有源
CI/CD 和 Docker 环境中镜像配置从不继承本地设置
GitHub Actions、GitLab CI 或 Docker 构建时，composer config -g 写的配置根本不存在——CI 默认以全新用户运行，不读你本机的 ~/.composer/config.json。
- 必须在 workflow 或 Dockerfile 中显式执行两行设置（Composer ≥ 2.2）：
composer config -g repositories.packagist.org.type composercomposer config -g repositories.packagist.org.url https://mirrors.aliyun.com/composer/ -
url末尾的/不能省，否则请求路径变成/p2/xxx.json，返回 404 或 SSL 错误 - 建议加
--no-interaction --no-cache参数，避免缓存干扰：composer install --no-interaction --no-cache - 最准验证：在 CI 日志中
grep "Downloading.*packages.json"，看域名是不是你设的镜像地址
缓存不清理，新配置永远发不出请求
改完配置不运行 composer clear-cache，本地元数据缓存仍指向旧地址，install 或 update 表面卡住，实则根本没发请求到新镜像——它还在用缓存里的 packagist.org 地址。
- 验证是否真走镜像，只看三处：
—composer config -g repo.packagist输出正确 JSON
—composer diagnose中 “Repo packagist.org:” 行后域名匹配镜像地址
—composer install -vvv | grep "Downloading"显示的 URL 含镜像域名，且无packagist.org - Windows Git Bash 下易写错位置：它默认找
%APPDATA%\Composer\config.json，而非~/.composer/config.json，echo %COMPOSER_HOME%才能确认真实路径
真正麻烦的从来不是“怎么配”，而是“配了以为对了，其实没生效”。所有静默失效都发生在配置写入、路径解析、缓存读取、优先级判断这四层之间，而 Composer 从不告诉你哪一层断了。
