Composer minimum-stability配置项详解（dev/alpha/beta/rc）

minimum-stability 控制 Composer 在未显式指定版本约束时默认允许安装的包稳定性级别，按 dev、alpha、beta、rc、stable 从低到高排序，影响自动选择带稳定性标识的预发布版本。

Composer 的 minimum-stability 决定了项目允许安装的包版本稳定性级别，默认是 stable。它不是“越稳定越好”，而是要和你的项目阶段、依赖策略、上线要求匹配——设得太严会装不上新功能，太松又容易引入不稳定的代码。

minimum-stability 控制什么？

它限制 Composer 在没有显式指定版本约束（如 "monolog/monolog": "^2.0@beta"）时，自动选择哪些预发布版本。只要包的版本号带稳定性标识（比如 v3.0.0-beta1、v2.8.0-rc2），就受此配置约束。

注意：它不强制所有依赖都降级到某个稳定性，只是设下“默认门槛”。你仍可通过在 require 中加 @dev、@alpha 等后缀，为单个包绕过该限制。

各稳定性级别的实际含义与风险

Composer 按以下顺序从低到高定义稳定性（越靠前越不稳定）：

• dev：对应 dev-main、dev-develop 这类开发分支，可能随时重写、无测试、无文档，仅适合本地实验或深度参与开源贡献
• dev（补充说明）：即使写成 "minimum-stability": "dev"，Composer 也不会自动装 dev-* 分支——除非你在 require 中明确写 "vendor/pkg": "dev-main"
• alpha：功能雏形已实现，但 API、数据库结构、配置格式都可能大改；通常无完整测试覆盖，不建议用于任何非沙箱环境
• beta：核心功能完成，API 基本冻结，开始集成测试；仍可能存在严重 bug 或性能问题，可小范围试用
• rc（Release Candidate）：候选发布版，目标是正式版 v1.0.0；除极少数临界 bug 外不应再改动；适合预上线验证
• stable（默认）：通过全部测试、有文档、有长期支持承诺的正式版本；生产环境唯一推荐选项

怎么合理设置？看场景选值

别全局一刀切。根据项目所处阶段和用途灵活调整：

标签： php laravel composer 工具 ai 金融