为什么Composer install报错提示未找到发布版本？分支名配置调整-composer-PHP中文网

答案是版本约束与源中实际发布的版本不匹配：运行composer show -a查看真实可用版本，注意分支名大小写、dev-前缀及稳定性标记；镜像常跳过dev分支，需切官方源或改用package类型显式声明。

为什么composer install报错提示未找到发布版本？分支名配置调整

composer install 报错 “Could not find a matching version” 是版本约束没匹配上

不是包不存在，也不是网络问题，而是你写的版本号或分支名根本没在源里发布过。比如写 "monolog/monolog": "^3.0"，但 Packagist 上最新 stable 版还是 2.10.0；或者写 "myorg/mylib": "dev-main"，但仓库默认分支其实是 master 或 develop。

运行 composer show -a vendor/package-name 查真实可用版本——输出的 versions 行才是 Composer 当前“看见”的全部记录，别信 GitHub tag 页面或 Packagist 网页显示
注意稳定性标记：v3.0.0@stable、dev-main@dev、v4.0.0-beta@beta 都算不同稳定性等级，^3.0 默认只匹配 @stable
分支名必须和远程仓库实际分支完全一致：dev-main ≠ dev-master ≠ dev-develop，大小写也敏感
私有 Git 仓库若用 type: "vcs"，Composer 会自动探测分支，但前提是能 clone 得通；SSH 权限、Token 过期、防火墙拦截都会导致探测失败，最终表现为“找不到分支”

dev-main 找不到？国内镜像默认不拉开发分支

阿里云、腾讯云等主流中文镜像为了节省带宽和合规审查，**默认跳过所有 dev- 开头的分支元数据同步**。即使你本地 git clone 能看到 main 分支，镜像的 packages.json 里也不会收录它。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

临时验证：加 --no-cache 强制走网络请求，如 composer show -a vendor/pkg --no-cache，如果这时能列出 dev-main，基本锁定是镜像问题
切回官方源测试：composer config --global repo.packagist composer https://packagist.org，再试 composer require vendor/pkg:dev-main

不想换源？改用 type: "package" 显式声明分支（适合私有包）：

{ "type": "package", "package": { "name": "vendor/pkg", "version": "dev-main", "source": { "url": "https://github.com/vendor/pkg.git", "type": "git", "reference": "main" } } }

repositories 配置错一个字段，Composer 就静默忽略

composer.json 里写了 repositories 却 still not found，大概率是 JSON 格式或字段名写错了。Composer 不报错，只是默默跳过整个配置，继续查 packagist.org。

必填字段只有 type 和 url（vcs 类型），type 值必须小写，如 "vcs"，写成 "VCS" 或 "git" 都无效
URL 必须可访问且协议明确：https://github.com/xxx/yyy.git 可行，github.com/xxx/yyy 或 git@github.com:xxx/yyy.git（没配 SSH key 时）会失败
多个源时，顺序很重要：Composer 从上到下查找，第一个匹配的源就停，后面同名包不会被覆盖
配置完别忘了删 provider 缓存：composer update --refresh（≥2.5）或手动删 ~/.composer/cache/repo/https---mirrors.xxx.com-composer

加 -w 参数反而让“找不到包”更频繁

composer require vendor/pkg -w 的本意是连带更新依赖树，但它会让 Composer 强制重算整个项目已装包的依赖约束。一旦某个旧包锁死了子依赖的低版本，而新包要求更高版，Composer 就放弃安装，报 Package not found——其实它是“无法满足依赖”，但错误信息误导性极强。