Composer无官方别名功能，所谓alias实为三种变通手段：版本伪装（as）、源接管（repositories+package）、包替代（replace）；用错将导致依赖解析失败或装错代码。
Composer 没有“别名功能”这个官方概念——你看到的 alias 全是变通手段，不是语言级特性。所谓别名，本质是绕过默认解析逻辑的三种 hack：版本伪装（as）、源接管（repositories + package）、或包替代（replace）。用错一种，composer update 就可能静默失败或装错代码。
别名不是起昵称，而是骗过依赖解析器
当你写 "monolog/monolog": "dev-fix as 2.9.2"，Composer 并不是给包起了个新名字，而是告诉解析器：“这个 dev-fix 分支，在版本检查时请当作 2.9.2 处理”。下游依赖若声明 "some/pkg": "^2.9"，才能通过校验。
-
as右侧必须是合法语义化版本号（如2.9.2、^3.0.0），不能是dev-main或1.x - 如果原包要求
"vendor/lib": "^3.0"，你 alias 成2.9.9，会直接报Your requirements could not be resolved -
composer install不触发 alias 重解析——它只读composer.lock；必须运行composer update vendor/lib或删 lock + vendor 后重装 - 执行
composer show vendor/lib -i，看输出里versions行是否显示* 2.9.2（带星号表示当前生效版本），否则 alias 未被识别
为什么 branch-alias 在 Composer 2.x 中完全失效
extra.branch-alias 字段在 Composer 2.0+ 中已被移除，任何配置都静默忽略。这不是 bug，是设计删除：它和 SemVer 冲突、Packagist 同步不可靠、下游无法感知真实来源。
- 你在包里写
"dev-main": "2.0.x-dev"，composer show仍只显示dev-main，不会出现2.0.x-dev - 下游项目写
"vendor/pkg": "^2.0"，根本匹配不到该分支，报Could not find a version - 正确替代方案只有两个：
git tag v2.0.0-beta.1（然后 push），或在包的composer.json中直接写"version": "2.0.x-dev"并配--stability=dev - 打 tag 是最兼容的做法——
v2.0.0-beta.1能满足^2.0，且 Packagist 自动同步，CI 构建可重现
repositories 配 package 类型才是真“安装别名”
想让 composer require monolog/monolog 实际拉你自己的 fork，不能只靠 as，得用 repositories + type: package 手动接管元信息。这是唯一能覆盖 Packagist 默认源的方式。
-
type必须为package（不是vcs），否则无法覆盖已注册包名 -
name字段必须和你要“别名”的包名完全一致（如"monolog/monolog"） -
version要精确（如"3.0.0"），且dist.url指向的 zip 包里必须含有效composer.json，结构与原始包一致 - 漏掉
dist.reference或dist.shasum会导致安装失败；私有仓库建议用dist.type: zip+ 完整 URL - 这种写法不依赖分支名，也不需要
as——它本质上是“伪造一个同名包”，Composer 会优先选它而非 Packagist 上的
真正容易被忽略的是：alias 从不改变代码行为，只影响版本匹配。你 alias 成 3.0.0，但实际删了 SomeClass::newMethod()，下游调用照样 fatal error——Composer 不校验方法是否存在，只校验版本字符串是否满足约束。
