别名是Composer中将开发分支映射为特定版本的机制，用于满足依赖约束。当使用dev分支时，可通过branch-alias在包的composer.json中设置，如将dev-main别名为2.0.x-dev；或在项目中通过vcs仓库配合as语法引用，如dev-main as 2.0.x-dev。此机制仅影响版本解析，不改变实际代码，适用于fork或开发调试场景，需确保别名格式正确且提交至对应分支。
在使用 Composer 管理 PHP 依赖时，有时你可能需要将某个包的版本“别名”成另一个版本号，以便满足其他依赖对特定版本的要求。这种机制叫做 版本别名（version alias），通常用于开发分支或自定义 fork 的场景。
什么是别名（Alias）？
当你在项目中使用一个 dev 分支（如dev-main），Composer 默认会将其识别为 dev-main 或对应的 9999999-dev 版本。但如果另一个包要求该依赖必须是 ^2.0，而你的 dev 分支其实是 2.0 的开发版，Composer 可能认为不满足约束。
这时你可以通过 别名 告诉 Composer：“这个 dev-main 分支实际上相当于 2.0.x-dev”，从而让它通过版本检查。
如何设置版本别名？
别名可以在两个地方设置：1. 在包的 composer.json 中设置 alias
如果你维护的是被依赖的包，可以直接在 composer.json 中添加 extra 字段指定分支的别名：
{
"name": "your-vendor/your-package",
"version": "dev-main",
"extra": {
"branch-alias": {
"dev-main": "2.0.x-dev"
}
}
}
这表示：当前 main 分支会被当作 2.0.x-dev 版本来处理。这样其他包就可以用 "your-vendor/your-package": "^2.0" 来依赖它。
2. 在项目中通过 VCS 别名引用
如果你 fork 了一个包并做了修改，想用自己的仓库替代原包，并为其设置别名，可以在项目的 composer.json 中这样写：
{
"repositories": [
{
"type": "vcs",
"url": "https://github.com/your-name/forked-package"
}
],
"require": {
"original-vendor/package": "dev-main as 2.0.x-dev"
}
}
这里的关键是 as 语法：dev-main as 2.0.x-dev 表示从该仓库拉取 dev-main 分支，并将其版本别名为 2.0.x-dev，从而满足依赖约束。
常见用途和注意事项
- 别名主要用于
dev分支，稳定版本不需要别名。 - 别名不会改变实际代码，只影响 Composer 的版本解析逻辑。
- 确保别名的版本格式正确，例如：以
.x-dev结尾，不能写成2.0或2.0-stable。 - 如果使用了
branch-alias，建议提交到对应分支的根composer.json中，否则别人无法感知。
