如何通过Composer安装特定分支版本的包？

本文共计969个文字，预计阅读时间需要4分钟。

直接使用composer require vendor/name:dev-branch-name就能安装，但90%的失败并不是命令写错，而是没有处理好稳定性策略、仓库源或分支命名规则。

为什么 composer require vendor/name:dev-main 报 “Could not find package”

Composer 默认只允许安装 stable 版本，dev- 开头的版本被当作开发版，必须显式允许。常见错误包括：

• 没加 --stability=dev（或简写 -s dev），导致 Composer 直接跳过匹配
• 包不在 Packagist 上注册，但又没在 composer.json 的 repositories 里声明 vcs 源
• 分支名大小写不一致 —— dev-Main 和 dev-main 是两个不同分支，Git 区分大小写
• 远程仓库根本没有 main 分支，或者拼错了（比如写成 master 但对方已切到 main）

dev-feature/login 这种带斜杠的分支怎么写

Composer 强制要求斜杠分支必须写成 dev-feature/login，不能省略 dev-，也不能把斜杠替换成短横线或下划线。