Composer 2.0+ 已完全移除 branch-alias 支持，extra.branch-alias 配置静默失效；应改用 version 字段声明如 "2.0.x-dev" 或打 v2.0.0-beta.1 等 Git tag 来满足 "^2.0" 约束。

Composer 2.0+ 已完全移除 branch-alias 支持，任何写在 extra.branch-alias 里的配置都不再被解析，也不起作用。 如果你还在用它解决版本依赖问题，大概率会失败，且错误提示不明确。

为什么 branch-alias 不生效了

Composer 1.x 时期靠它把 dev-main 映射成 1.0.x-dev，让下游项目能用 "^1.0" 拉分支。但这个机制和语义化版本（SemVer）冲突、依赖方无法感知、Packagist 同步不可靠，所以 Composer 2.x 直接砍掉了整段解析逻辑。

常见现象包括：

• composer show vendor/package 仍只显示 dev-main，从不显示你配的 1.0.x-dev
• 下游项目写 "vendor/package": "^1.0" 完全匹配不到，报 Could not find a version
• 即使 push 了新 composer.json 到远程，Packagist 页面也看不到别名变化

替代方案：用 version 字段 + --stability=dev

真正可控、兼容 Composer 2.x 的做法，是放弃“自动映射”，改用显式声明：

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

• 在你要发布的包的 composer.json 中，直接设 "version": "2.0.x-dev"（不是放在 extra 里）
• 确保 Git 分支名就是 main（或 develop），不要加 dev- 前缀——Composer 会自动识别该分支为 2.0.x-dev 版本
• 下游项目执行 composer require vendor/package:2.0.x-dev --stability=dev 即可安装
• 若想全局允许 dev 版本，可在项目根目录 composer.json 的 config 段加 "minimum-stability": "dev"，但生产环境慎用

注意：version 字段必须带 -dev 后缀，否则会被当作稳定版处理，触发 conflict 或 require 失败。

如果必须支持 "^2.0" 这类约束

只能靠 Git tag 配合稳定性策略，而不是 branch-alias：

• 在 main 分支上打一个轻量 tag：git tag v2.0.0-beta.1，然后 push：git push origin v2.0.0-beta.1
• Composer 会把 v2.0.0-beta.1 解析为 2.0.0-beta.1，满足 "^2.0" 约束
• 后续持续打 v2.0.0-beta.2、v2.0.0-rc.1 等，就能自然升级
• 避免用 dev-main 长期锁 commit hash —— force push 后 composer.lock 里的 hash 就失效，CI 构建直接崩

最易被忽略的一点：branch-alias 的历史残留配置（比如旧文档、脚手架模板里的 extra.branch-alias）不会报错，只是静默失效。检查是否还在用它，比花时间调试更省事。