branch-alias是Composer中将开发分支映射为预期语义化版本的机制，如将dev-main映射为2.0.x-dev，使其他包可通过^2.0依赖该开发版本，Composer在解析时会自动匹配别名并检出对应分支，实现前瞻式依赖与版本兼容管理。
Composer 在处理带有 branch-alias 的包版本时，主要是为了将开发分支（如 dev-main）映射到一个预期的语义化版本号，以便其他包可以依赖“未来”的稳定版本。这个机制常见于主干开发中，比如你正在开发 2.0 版本，但尚未打标签。
什么是 branch-alias？
branch-alias 是在 composer.json 的 extra 字段中定义的一个配置项，它告诉 Composer：某个分支虽然当前没有打版本标签，但你可以把它当成某个版本来使用。
{
"extra": {
"branch-alias": {
"dev-main": "2.0.x-dev"
}
}
}
这表示：当前的 main 分支被视为 2.0.x-dev 版本。
Composer 如何解析 branch-alias？
当另一个项目尝试依赖该包的 2.0.* 版本时，Composer 会：
- 查找可用的版本，包括开发版本（如
1.0.x-dev,2.0.x-dev） - 发现没有实际的
2.0.0标签，但存在一个分支别名将dev-main映射为2.0.x-dev - 于是 Composer 将克隆该仓库，并检出
main分支，将其当作2.0.x-dev安装
这个过程对依赖方透明。他们只需写：
{ "require": { "your-vendor/your-package": "^2.0" } }Composer 就能匹配到
2.0.x-dev 这个别名所指向的开发分支。branch-alias 的典型用途
- 支持前瞻式依赖：允许用户提前使用即将发布的版本（如 3.0 开发中）
- 避免版本冲突：防止多个开发分支被误认为是同一版本系列
-
兼容性管理：确保
^2.0能正确匹配到 2.0 的开发进展，而不是回退到 1.x
注意事项
- branch-alias 不影响实际的 Git 分支名称，只是虚拟映射
- 必须写在目标包的
composer.json中（通常是源码仓库） - 仅对开发版本有效（以
-dev结尾），不能用于稳定版本 - 别名格式推荐使用
X.Y.x-dev形式，符合 Composer 版本解析规则
基本上就这些。Composer 通过 branch-alias 实现了开发分支与语义化版本的桥接，让依赖管理更灵活、可预测。不复杂但容易忽略细节。
