直接装 dev-master 可行但默认被 Composer 拒绝,因其 minimum-stability 默认为 stable,将 dev- 分支视为不稳定而过滤;可通过 composer require vendor/package:dev-master、调整 minimum-stability 或锁 commit 哈希解决,但存在不可重现、易崩等风险。

直接装 dev-master 是可行的,但默认会被 Composer 拒绝——它只信任稳定版本,除非你明确告诉它“我清楚风险”。
为什么 composer require 默认不装 dev-master
Composer 默认把 minimum-stability 设为 stable,所有 dev- 开头的分支(包括 dev-master)都被视为不稳定,直接跳过。这不是 bug,是保护机制。
- 常见错误现象:
Could not find package xxx at version dev-master或no matching package found - 本质不是包不存在,而是稳定性过滤器把它筛掉了
- 即使包仓库里真有
dev-master分支,也会被忽略
三种能装上 dev-master 的方法(按推荐顺序)
优先选最细粒度的控制,避免全局降级稳定性:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 对单个包临时放宽:运行
composer require vendor/package:dev-master—— 这会自动在composer.json中加"vendor/package": "dev-master",并把该包的稳定性约束写进require字段,不影响其他包 - 局部放宽整个项目:在
composer.json里加"minimum-stability": "dev",再执行composer require;但注意这会让所有未显式指定稳定性的依赖都可能拉dev-分支,容易翻车 - 加
"prefer-stable": true配合"minimum-stability": "dev",能让 Composer 在满足dev前提下优先选 stable 版本,稍微安全一点
dev-master 的实际行为和隐藏风险
它不是指向某个固定提交,而是实时跟踪远程 master 分支的最新 commit。这意味着:
- 不同时间
composer install可能装到完全不同的代码,CI 构建结果不可复现 - 如果作者 force-push 了
master,你下次composer update可能直接 break - 没有版本号语义,无法用
^或~做兼容性约束 - 某些包的
dev-master可能连autoload都没配好,class not found是家常便饭
更稳妥的替代方案(别总盯着 dev-master)
尝鲜不等于瞎试,多数场景有更可控的选择:
- 查包的 GitHub/GitLab 页面,看有没有带
dev-前缀的正式开发分支(如dev-next),它们通常比dev-master更有维护意识 - 用
composer require vendor/package:dev-feature-branch-name明确指定功能分支,范围更小、意图更清 - 直接
composer require vendor/package:dev-master#commit-hash锁死某次提交,比如dev-master#abc1234,兼顾新鲜感与可重现性
真正麻烦的从来不是怎么装上去,而是没人告诉你 dev-master 本质上是个移动靶——你拉下来的那一刻,它就已经开始漂移了。

















