版本别名可将开发分支映射为特定版本号，通过在被依赖包的composer.json中设置branch-alias实现，如将dev-main别名为2.0.x-dev，使其他包能按版本约束引用该分支。
在使用 Composer 管理 PHP 项目依赖时，有时你可能需要为某个包的版本创建别名（alias），特别是当你想让一个开发分支（如 dev-main）表现得像某个稳定版本（如 1.0.0），以便满足其他依赖包的版本约束。Composer 提供了“版本别名”机制来实现这一点。
什么是版本别名（Alias）？
版本别名允许你将一个实际的开发版本（例如 dev-feature 或 dev-master）映射到一个特定的版本号（如 1.2.3）。这在你本地开发一个包，并希望另一个项目将其当作某个正式版本引用时非常有用。
比如：你的包当前是 dev-main，但你想让它被当作 2.0.0 使用，就可以通过设置别名实现。
如何为依赖包创建版本别名？
版本别名是在被依赖的包（即你正在开发的那个库）的 composer.json 文件中设置的，而不是在使用它的项目里。
- 打开你要设置别名的包的
composer.json文件 - 在根层级添加
"version"和"extra"字段中的branch-alias - 指定某个分支对应的目标版本
示例：
假设你的包主分支是 main，你想让 main 分支被视为 2.0.x-dev 版本：
{
"name": "your-vendor/your-package",
"version": "2.0.0",
"extra": {
"branch-alias": {
"dev-main": "2.0.x-dev"
}
}
}
这样，当其他项目通过 "your-vendor/your-package": "^2.0" 引用时，Composer 就能识别 dev-main 分支符合这个约束，因为它被别名为 2.0.x-dev。
常见用途和注意事项
- 用于开发中的包：你在开发一个库的 2.0 版本，尚未打 tag，但希望主干能被当作 2.0 使用。
-
分支命名要准确：如果分支是
master，就写dev-master；如果是develop，则写dev-develop。 - 别名不会创建真实版本：它只是告诉 Composer “把这个分支当成某个版本来处理”。
- 仅作用于 dev 分支：tag 的版本不需要别名，它们已经有明确版本号。
例如，Laravel 的组件常使用这种机制：
"branch-alias": {
"dev-master": "10.x-dev"
}
在项目中测试别名效果
如果你在本地开发包，可通过 path 方式引入测试：
"repositories": [
{
"type": "path",
"url": "../your-local-package/"
}
]
然后运行 composer require your-vendor/your-package:~2.0.0，Composer 会拉取你本地的 main 分支并识别其别名。
基本上就这些。正确设置 branch-alias 能让你的开发流程更顺畅，尤其在维护多个相互依赖的私有包时特别实用。别名虽小，但在版本协调上很关键。
