minimum-stability必须写在composer.json顶层,与require同级,值为小写dev/alpha/beta/RC/stable(RC须全大写),并必须配合"prefer-stable": true使用,否则可能安装不稳定版本;它仅约束未显式标注稳定性的依赖。

minimum-stability 必须写在 composer.json 顶层
它不是命令行参数,也不是 config 或 extra 下的子字段。写错位置(比如塞进 config 里)就完全不生效。正确位置是和 require、autoload 同级:
{
"minimum-stability": "beta",
"prefer-stable": true,
"require": {
"monolog/monolog": "^3.0"
}
}
值必须全小写,仅限 dev、alpha、beta、RC、stable —— 注意 RC 必须大写,rc 或 Rc 会被忽略,退回到默认 stable。
prefer-stable: true 不是可选项,是必要配套
只设 "minimum-stability": "beta" 而不配 "prefer-stable": true,Composer 可能选 v3.0.0-beta3 而不是已发布的 v2.9.5(stable),哪怕后者完全满足 ^2.0 约束。因为 beta 版本“更新”,更符合语义版本优先逻辑。
-
prefer-stable: true的意思是:在所有满足minimum-stability的候选版本里,优先挑最稳定的那个 - 它必须和
minimum-stability同时存在才起作用;单独写没意义 - 典型安全组合就是
{"minimum-stability":"beta","prefer-stable": true}
它只约束没显式标注稳定性的包
minimum-stability 不是全局开关,它只影响那些“没写稳定性后缀”的依赖声明。例如:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
-
"monolog/monolog": "^3.0"→ 受minimum-stability约束 -
"monolog/monolog": "^3.0@stable"→ 完全绕过,强制走 stable -
"monolog/monolog": "dev-main"→ 也绕过,直接走 dev 分支
所以你加了 minimum-stability: "beta" 却报 Could not find package,大概率不是配置失效,而是目标包压根没发布任何 beta 或以上版本——用 composer show -a vendor/package 看真实可用标签,比如只看到 v1.5.0 (stable),那 @beta 就必然失败。
私有包或本地 path 包不受 minimum-stability 影响
path 类型仓库(比如 "type": "path")的版本由其自身 composer.json 中的 version 字段决定,不是靠 minimum-stability 过滤。即使你设了 "minimum-stability": "stable",只要本地包写了 "version": "1.2.3",它就会被装进来。
- 本地包不能用
composer require vendor/name:1.2.3,会报Could not find a matching version - 必须在主项目
repositories里声明 path 源,require里只写包名 +"*"或"1.2.3"(后者是约束,非强制) - 要让版本号生效,得关掉 symlink:
"config": {"symlink": false},再composer update vendor/name
真正容易被忽略的是:这个设置对整个依赖树生效,但团队协作中,单包加 @beta 比全局降 minimum-stability 更精准、更安全——除非你在统一做 beta 验证。

















