alias 是 require 中对包版本的别名声明，格式为“dev-branch as version”，用于将开发分支等非标准版本映射为稳定版本号，以满足依赖约束、绕过 CI 限制或保持 lock 文件语义清晰。
什么是 composer.json 中的 alias？
alias 不是独立配置项，而是 require 里对某个包版本的“别名声明”，本质是让 Composer 把一个非标准版本号（比如开发分支、自定义 tag）当作某个稳定版本来处理。它只在 require 的值中以 dev-branch as version 形式出现，例如："monolog/monolog": "dev-main as 2.10.0"。Composer 会据此解析依赖约束，但不会改变包的真实源码来源。
as 别名能解决哪些实际问题？
典型场景是：你正在维护一个依赖 package-a 的项目，而 package-a 的 main 分支已修复了关键 bug，但尚未发布新正式版（如 3.2.1）。此时你想让当前项目“假装”用的是 3.2.1，以便其他依赖能按该版本约束正常安装。
- 避免因使用
dev-main导致其他包拒绝兼容（它们可能只声明支持^3.2，不认dev-前缀） - 绕过某些 CI/CD 工具对
dev-版本的拦截（如禁止部署 dev 分支） - 在本地测试新版行为，同时保持
composer.lock中版本号语义清晰
别名写法错误会导致什么？
常见错误包括：把 as 写在 repositories 或 config 里、误以为 alias 是全局配置、或混淆了 as 和 provide。这些都会让 Composer 忽略别名，甚至报错。
正确写法只有一种位置：
{
"require": {
"vendor/package": "dev-feature/x as 1.5.0"
}
}
错误示例（会被忽略）：
{
"config": {
"alias": { "vendor/package": "dev-main as 2.0.0" }
}
}
另外注意：as 后面的版本号必须满足该包 composer.json 中声明的 version 字段或其分支别名规则，否则 Composer 会提示 Could not parse version constraint。
如何让多个大版本共存？alias 并不适用
alias 不能实现“同一包多个主版本共存”。比如想同时用 symfony/console 的 v5.4 和 v6.4，这是 Composer 架构本身禁止的——每个包在 vendor/ 下只能有一个实例。
可行替代方案只有两个：
- 拆分为独立子项目（各自
composer.json+vendor），通过 CLI 调用或 API 通信 - 使用
replace+provide模拟兼容层（极少见，仅限高度定制的 SDK 场景）
试图靠 "old/package": "dev-v1 as 2.0.0" 和 "old/package": "dev-v2 as 3.0.0" 同时 require，Composer 会直接报 Package old/package is abandoned 或冲突终止。
2.0.0），运行时就崩。用之前，务必确认那个 dev- 分支确实达到了你所 alias 的版本契约。 
