镜像失效主因是配置未生效而非源挂了；写错字符、漏斜杠或多字母会导致Composer静默退回packagist.org且不报错；需通过diagnose、-vvv日志及检查项目级repositories确认真实生效。
镜像失效不是“源挂了”，而是配置没真正生效——写错一个字符、漏一个斜杠、多一个字母，Composer 都会静默退回 packagist.org，且不报错、不提示、不 fallback。
为什么 composer config -g repo.packagist 看似成功却没用
这条命令在 Composer 2.2+ 中已处于“兼容层”，实际只认 repositories.packagist.org，但命令本身不校验字段合法性，导致三类硬伤常被忽略：
-
repo.packagist写成repos.packagist（多一个 s）或repositories.packagist.org（键名对但命令不支持），直接静默忽略 - 漏掉第三参数
composer：正确写法是composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，少composer就退回到官方源 - URL 缺末尾
/：写成https://mirrors.aliyun.com/composer会导致路径拼成/composer/p2/xxx.json，返回 404，Composer 自动弃用该镜像
怎么确认镜像真正在用，而不是“我以为它在用”
别信 composer config -g repo.packagist 的输出，它只告诉你“存了什么”，不反映运行时行为。真实证据只有三处一致：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer diagnose，找到Repo packagist.org:这一行，后面域名必须是mirrors.aliyun.com或你配的镜像域名 - 执行
composer require monolog/monolog --no-install -vvv，第一行日志里Downloading https://后的地址才是真实请求源 - 检查项目级覆盖：进项目目录运行
composer config repositories，如果有输出（哪怕为空数组），说明composer.json里的"repositories"字段正在接管，全局配置完全失效
换源后仍 404 或卡住，核心要清三样东西
镜像地址对、diagnose 显示正确、-vvv 日志也走镜像，但还是 404？大概率是旧数据残留：
- 删掉
vendor/和composer.lock：composer.lock里硬编码了旧 provider 地址（如https://packagist.org/p2/monolog/monolog.json），换源后 Composer 仍优先尝试这个 URL，失败即终止（新版无 fallback） - 执行
composer clear-cache：清除本地元数据缓存，否则仍从旧地址拉取校验信息 - Windows 用户额外手动删
%LOCALAPPDATA%\Composer\cache：CLI 缓存路径与 GUI 工具可能不一致，clear-cache有时漏清
临时切源比永久配置更安全，尤其在 CI 或帮别人调试时
改全局配置容易污染环境、难追溯问题，而临时方式可精准验证、不留副作用：
- 单次命令指定源：
composer install --repository-url=https://mirrors.aliyun.com/composer/ - 仅当前项目生效（不写进
composer.json）：composer config repo.packagist composer https://mirrors.ustc.edu.cn/composer/ - 强制绕过所有配置（含项目级）：
composer install -vvv --repository-url=https://mirrors.huaweicloud.com/repository/php/composer/
最常被忽略的是项目级 repositories 字段的屏蔽效应——只要它存在，哪怕内容是空数组或 {"packagist.org": false}，全局镜像就彻底失效，且没有任何警告。
