Composer 2.2+ 中 branch-alias 已被官方移除，extra.branch-alias 配置被忽略；唯一可靠方式是使用 require 中的 as 语法，如 dev-main as 2.0.0，并配合 repositories 指向对应分支。
Composer 的分支别名（branch-alias）在 Composer 2.2+ 中已**不生效**——它被官方移除，任何写在 extra.branch-alias 里的配置都会被忽略。你现在看到的“别名生效”，大概率是旧缓存、本地 path repo 误判，或你实际用的是 as 语法而非 branch-alias。
为什么 branch-alias 不再起作用
Composer 2.0 起彻底删除了对 extra.branch-alias 的解析逻辑。这不是 bug，是设计移除。它的核心缺陷在于：依赖方无法感知别名存在，且与 SemVer 解析规则冲突。所以即使你按文档写了：
{"extra": {"branch-alias": {"dev-main": "2.0.x-dev"}}}
Composer 也会当它不存在。验证方式很简单：
- 运行
composer show vendor/package—— 如果只显示dev-main，没出现2.0.x-dev，说明别名没生效（也确实不会生效） - 下游项目写
"vendor/package": "^2.0"仍报错“no matching package found”，就是典型表现 - 别名只在 Packagist 元数据中参与远程解析，而 Composer 2.x 根本不读这个字段
as 语法才是当前唯一可靠的方式
想让一个分支满足版本约束（比如让 dev-feature/login 被当成 1.5.0 来安装），必须用 require 行里的 as 显式声明：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer require vendor/package:dev-feature/login as 1.5.0- 必须写全分支前缀：
dev-不能省，main就得写成dev-main -
as后面只能是合法 SemVer 字符串（如1.5.0、2.0.0-beta.1），不能是latest或stable - 如果目标分支不在官方仓库，必须配合
repositories指向你的 fork 或 PR ref
例如测试 GitHub PR #123：
{
"repositories": [
{
"type": "vcs",
"url": "https://github.com/yourname/package.git",
"ref": "pull/123/head"
}
],
"require": {
"vendor/package": "dev-pr-123 as 2.1.99"
}
}
常见踩坑点：你以为在配别名，其实根本没走那条路
很多开发者以为自己在用 branch-alias，但实际生效的是其他机制：
- 本地
pathrepository：它绕过所有版本解析，branch-alias和as都无效，直接 symlink - 手动打
v2.0.0tag：这跟别名无关，是真实版本发布 - Composer 把
dev-main自动映射为9999999-dev：这是默认 fallback 行为，不是你配的别名生效了 - 缓存残留：删掉
vendor/、composer.lock和~/.composer/cache后重试，才能确认真实行为
真正需要分支别名语义的场景（比如主干开发长期支持 ^2.0），现在只能靠 as + repositories 组合硬编码，或者干脆提前打 2.0.x-dev tag 并设 "minimum-stability": "dev"。别名机制本身，已经退出历史舞台了。
