“Unknown distribution”报错源于composer.lock或缓存provider文件中存在已被废弃的dev-master等非语义化分支名，新版本Composer（2.5+）默认拒绝解析，与镜像源无关；需删除vendor/、composer.lock及缓存，并临时禁用providers-url解决。
“Unknown distribution” 报错和镜像源无关，是 Composer 在解析 packages.json 时，发现某个 provider 文件里声明了不支持的发行版（如 dev-main、dev-develop 或已删除的 dev-master），而当前 Composer 版本拒绝加载——不是网络问题，也不是镜像没切对。
为什么 composer install 突然报 “Unknown distribution”
这个错误通常出现在升级 Composer 到 2.5+ 或 PHP 8.4+ 后，核心原因是：dev-master 等非语义化分支名已被官方废弃，新版本 Composer 默认禁用解析；但旧 composer.lock 或镜像缓存中仍存有含该字段的 provider 元数据，一读就炸。
- 不是镜像源返回了错数据，而是你本地缓存/lock 文件里“记着一个 Composer 不再认的发行版”
- 阿里云、腾讯云等镜像本身不改 provider 内容，只同步原始结构，所以换源不解决此问题
- 常见触发场景：从老项目拉代码后直接
composer install，或 CI 流水线复用旧 cache
composer why-not dev-master 并不存在，正确排查路径是看锁文件和 provider 缓存
别搜不存在的命令。真实线索藏在 composer.lock 和缓存 provider JSON 里：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 打开
composer.lock，搜索"dev-master"或"dev-develop"—— 如果存在，说明 lock 文件生成时用了过时分支策略 - 运行
composer install -vvv，末尾会打印类似Reading /home/user/.composer/cache/repo/https---mirrors-aliyun-composer/p/provider-2025-07%24.json的路径，把该 URL 拷进浏览器或curl -s查看内容，搜索"dev-master" - 若 provider JSON 里有
"dev-master": {"commit": "...", "dist": {...}}，说明镜像尚未清理该废弃字段（同步延迟或上游未更新）
三步清除“Unknown distribution”错误（不重装、不降级）
这不是配置问题，是元数据污染。必须清源头，不能只换镜像：
- 删掉
vendor/和composer.lock—— 锁文件是罪魁，它固化了已失效的分支引用 - 执行
composer clear-cache，Windows 下额外检查并手动清空%LOCALAPPDATA%\Composer\Cache\ - 临时禁用 provider 优化（关键）：
composer config -g providers-url false，再跑composer install；成功后再恢复：composer config -g --unset providers-url
长期规避：避免 dev- 分支进入 lock 文件
开发中习惯性 composer require vendor/pkg:dev-main 很危险——它会把 dev-main 写死进 lock，后续任何 Composer 升级都可能翻车：
- 用稳定版本替代：
composer require vendor/pkg:^3.0，或至少指定 commit hash：composer require vendor/pkg:dev-main#abc123 - CI 脚本中加保护：
composer install --no-dev可跳过 dev 分支解析（如果它们只在 require-dev 里） - 项目根目录加
.composer-auth并设"minimum-stability": "stable"，防止意外拉到 dev 分支
真正卡住你的从来不是镜像速度，而是 lock 文件里那行早已被 Composer 抛弃的 "dev-master" —— 它不会报错提示你删，只会等你亲手把它连根拔起。
