分支别名是让 Composer 将开发分支（如 dev-main）伪装成语义化版本号（如 2.0.x-dev）以参与版本解析的机制，仅在 minimum-stability 拦截 dev 分支且需满足版本约束时使用，必须定义在被依赖包的 composer.json 中，且别名格式须为 X.Y.x-dev。
分支别名（Branch Alias）不是绕过冲突的捷径，而是让 Composer 把开发分支“伪装”成一个语义化版本号，从而参与版本解析。它只在你明确需要某个 dev- 分支、又不想被 minimum-stability 拦住时才真正有用——比如你正在等一个 PR 合并，但上游还没发正式版。
什么时候必须用分支别名？
当你看到 could not find a matching version，且确认包存在、拼写无误、仓库配置正确，但目标分支（如 dev-main 或 dev-feature/x）没被识别为合法版本时，说明 Composer 默认不把它当“可用版本”。这时分支别名就派上用场了。
- 你依赖的包只有
dev-main分支，但你的项目minimum-stability是stable - 你想让
dev-main被当作2.0.x-dev参与版本求解（例如满足另一个包的^2.0约束） - 你维护一个库，希望下游能用
"my/package": "^2.0"安装你的dev-main分支，而不是硬写"my/package": "dev-main"
怎么写分支别名？
别名必须写在**被依赖方**的 composer.json 里，不是你自己的项目。常见写法是：
{
"extra": {
"branch-alias": {
"dev-main": "2.0.x-dev"
}
}
}
关键点：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
dev-main是真实分支名，必须完全匹配远程仓库的分支名（大小写敏感） -
2.0.x-dev是别名，格式必须是X.Y.z-dev，其中X.Y部分要能匹配其他包的约束（如^2.0或~2.0.0） - 别名不能是
1.99.99这类非法 SemVer；也不能写成2.0-dev（缺少.x），否则 Composer 不认 - 如果你控制不了被依赖包的
composer.json（比如是第三方库），那分支别名这条路就走不通
为什么写了别名还是装不上？
分支别名生效的前提是：Composer 能读到这个 composer.json。但很多情况它根本看不到：
- 你通过
repositories添加的是package类型（手动定义包信息），而非vcs，那么extra.branch-alias不会被加载 - 你用了
path类型仓库，但路径下没有composer.json，或文件权限导致读取失败 - 你本地改了被依赖包的
composer.json，但没提交也没打 tag，Packagist 不会同步，别人composer install时仍拉旧版 -
composer clear-cache后仍无效？试试composer update --with=vendor/package:dev-main强制触发解析
别名解决不了的冲突，别硬套
分支别名只影响“版本字符串如何被解释”，不改变依赖树逻辑。如果两个包分别要求 monolog/monolog:^1.0 和 monolog/monolog:^3.0，你给 monolog 的 dev-main 加个 2.0.x-dev 别名，依然无法满足——2.0.x-dev 不在 ^1.0 范围内，也不在 ^3.0 范围内。
这时候该用 composer why-not monolog/monolog:3.0.0 定位谁卡住了升级，而不是反复调别名格式。真正的冲突根因，永远藏在 why-not 的输出里，而不是 composer.json 的写法里。
