Composer全局镜像配置失效的主因是命令写法错误：repo.packagist必须单数小写、type值显式指定、url需HTTPS且末尾带/；验证需输出完整JSON，否则未写入；推荐使用清华、阿里云等2026年实测可用镜像，并优先采用项目级配置+清缓存+重装。
composer config -g repo.packagist 为什么没生效
根本不是网络或权限问题，而是命令写法错得非常安静：缺一不可的三个条件没同时满足，Composer 就会静默 fallback 回官方源，你却完全不知道。
-
repo.packagist必须是单数、全小写；写成repos.packagist或Repo.Packagist都无效 -
type值必须显式传入composer，不能省略，也不能当注释写在后面 -
url必须是 HTTPS，且末尾带/（比如https://mirrors.aliyun.com/composer/）；少斜杠会导致请求路径拼成/composerpackages.json，直接 404
验证是否真写进去了：运行 composer config -g repo.packagist。正确输出应是完整 JSON 对象，例如：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。返回空、null 或报错，说明压根没写入。
镜像地址本身已失效或同步滞后
很多 404 实际上不是你配错了，而是镜像源自己挂了、停服了，或者新包还没同步过来——尤其当你装的是刚发布的 dev-main 或带 commit hash 的私有版本时。
- 已确认停用的旧镜像包括：
https://packagist.laravel-china.org（2023 年底下线）、https://packagist.phpcomposer.com（2025 年起不可用） - 推荐实测可用的 2026 年稳定镜像：
https://mirrors.tuna.tsinghua.edu.cn/composer/、https://mirrors.aliyun.com/composer/、https://php.cnpkg.org/ - 手动验证镜像是否活着：
curl -I https://mirrors.tuna.tsinghua.edu.cn/composer/packages.json，秒回HTTP/2 200才算真正可用
别信“我昨天还能用”，镜像服务可能随时调整策略或临时限流，尤其 CI 环境里高频请求更容易触发 403/404 混合错误。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
项目级配置比全局配置更可靠
全局配置（-g）在团队协作和 CI 中极易出问题：不同成员本地镜像不一致 → composer.lock 的 hash 不同；CI 流水线以 www-data 用户运行，但 -g 配的是 root 的配置 → 白配。
- 进项目根目录执行：
composer config repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/ - 这条命令会安全地往
composer.json的repositories字段追加一条记录，不覆盖已有私有源 - 务必紧接着加上：
"packagist": false，否则 Composer 仍可能 fallback 到内置packagist.org触发超时
提交 composer.json 后，所有协作者和 CI 都能拿到一致行为，这才是可复现、可审计的配置方式。
404 日志里还出现 packagist.org？说明清理没到位
即使你已经换好镜像、配对参数，composer install 日志里如果还频繁出现 packagist.org 的请求路径，那基本可以断定：缓存或 lock 文件还在固执地拉旧地址。
- 必须按顺序执行：
composer clear-cache→ 删除项目下的vendor/和composer.lock→ 再跑composer install -vvv -
-vvv是关键：它会打印每一步的真实请求 URL，看到mirrors.tuna.tsinghua.edu.cn才算真正走镜像 - 别用
composer update替代install：update 会复用composer.lock里已失效的 provider 地址，继续 404
最常被忽略的一点：Composer 缓存里存的是 provider 文件的完整 URL（比如 p/provider-2025-10%24json），一旦镜像切换或包下架，这个缓存就会持续触发 404，哪怕你已经改了配置 —— 清缓存不是可选项，是必做前置动作。
