版本别名是将开发分支映射到虚拟语义化版本的功能，通过在composer.json的extra.branch-alias中配置，如将dev-main设为1.2.x-dev，使其他包可依赖该虚拟版本并使用对应分支代码。

在 Composer 中，你不能直接为同一个包的不同版本设置“别名”，但可以通过 版本别名（version alias） 的方式，将某个开发分支（如 dev 分支）映射到一个特定的版本号，从而让其他包可以依赖这个“虚拟版本”。

什么是版本别名？

版本别名允许你将一个开发分支（例如 dev-main）标记为某个语义化版本（如 1.2.3），即使该版本尚未正式发布。这在开发中特别有用，比如你想让另一个包依赖 my/package:1.2.3，而这个版本还在 main 分支上开发。

如何设置版本别名？

在你要设置别名的包的 composer.json 文件中，使用 extra.branch-alias 字段：

{     "name": "vendor/my-package",     "extra": {         "branch-alias": {             "dev-main": "1.2.x-dev",             "dev-develop": "2.0.x-dev"         }     } }

上面的配置表示：

• dev-main 分支被视为 1.2.x-dev 版本
• dev-develop 分支被视为 2.0.x-dev 版本

这样，其他包就可以这样依赖：

{     "require": {         "vendor/my-package": "1.2.x-dev"     } }

Composer 会自动使用 main 分支的代码来满足这个依赖。

居然设计家

居然之家和阿里巴巴共同打造的家居家装AI设计平台

64

查看详情

使用场景说明

假设你正在开发一个库，主分支是 main，你希望提前测试它作为 1.2.0 的兼容性，但还没打 tag。通过设置别名：

• 避免频繁更新依赖中的分支名称
• 支持版本约束匹配（如 ~1.2.0）
• 便于 CI/CD 或内部项目提前集成未发布版本

注意事项

版本别名只对 -dev 分支有效（如 dev-main），不会影响已发布的版本（如 v1.2.3）。

别名不会创建新版本，只是改变了 Composer 对分支的版本解析方式。

确保别名格式符合语义化版本，并以 .x-dev 结尾（如 1.2.x-dev），否则可能无法正确匹配。

基本上就这些。合理使用 branch-alias 能让你的开发流程更灵活。