可在 composer.json 中为单个包用 "@stable"、"@dev" 等后缀指定稳定性,优先级高于 minimum-stability;配合 "prefer-stable": true 和 branch-alias 可实现精细控制,require-dev 同样支持独立标记。

可以在 composer.json 中为每个包单独指定稳定性要求,无需全局统一。关键是利用 require 或 require-dev 中的包名后缀语法(如 "monolog/monolog:@dev"),覆盖默认的 minimum-stability 设置。
直接在包名后加稳定性标记
这是最常用、最清晰的方式。Composer 支持在包版本约束中直接写明稳定性标识,比如:
-
"phpunit/phpunit":"^9.5@stable"—— 强制只安装稳定版 -
"laravel/framework":"^10.0@dev"—— 允许安装 dev 分支(如10.x-dev) -
"myvendor/mypackage":"dev-main@dev"—— 明确使用 main 分支且允许不稳定代码
这种写法优先级高于 minimum-stability,对单个包生效,不影响其他依赖。
配合 minimum-stability 和 prefer-stable 控制全局倾向
虽然可以逐个指定,但建议搭配全局配置让行为更可预期:
-
"minimum-stability": "stable"—— 默认只接受 stable、RC、beta 等(不含 dev) -
"prefer-stable": true—— 当有 stable 版本可用时,优先选它(即使你写了@dev,只要 stable 满足版本范围也会用 stable)
例如:"monolog/monolog":"^2.0@dev" + "prefer-stable":true,仍可能装 2.10.0(stable)而非 2.11.x-dev,除非 stable 版本不满足 ^2.0 范围。
用别名(alias)或分支别名微调 dev 包行为
对于开发中的包,有时需要确保拉取特定分支并标记为某个稳定版本号(比如让 dev-main 被当作 3.0.x-dev 使用):
- 在被依赖包的
composer.json中设置:"extra": {"branch-alias": {"dev-main": "3.0.x-dev"}} - 然后你在项目中写:
"myvendor/mypackage":"3.0.x-dev"或"myvendor/mypackage":"dev-main@dev"
这样既明确指向开发分支,又能让版本解析和冲突检测更可靠。
注意 require-dev 中的独立控制
require-dev 下的包默认不受 require 的稳定性限制影响,也可以各自加 @stable 或 @dev:
-
"phpunit/phpunit":"^10.0@stable"—— 测试工具用稳定版 -
"orchestra/testbench":"^8.0@dev"—— Laravel 测试框架用最新开发版适配新特性
这很常见:生产依赖求稳,开发/测试依赖可激进些。
基本上就这些。不需要额外插件或复杂配置,靠包名后缀 + 合理的全局策略就能灵活管理混合稳定性需求。










