如何在 Composer 中安装不稳定的开发版本（@dev, @alpha）？

在 Composer 中安装不稳定开发版需显式指定版本约束（如 dev-main、6.5.x-dev 或 10.5.0@alpha），并根据需要调整 minimum-stability 配置或使用 --stability=dev 参数，同时避免在生产环境直接使用无锚点的 dev 分支。

在 Composer 中安装不稳定的开发版本，关键在于明确指定版本约束，并确保 minimum-stability 设置允许该稳定性级别。

明确指定 @dev 或 @alpha 等稳定性标识

Composer 默认只安装 stable 版本（如 1.0.0），若要安装开发版，需在 require 中显式加上稳定性后缀：

• "monolog/monolog": "dev-main" —— 安装 main 分支的最新提交（对应 @dev）
• "symfony/console": "6.5.x-dev" —— 安装 6.5 分支的开发快照
• "laravel/framework": "11.x-dev" —— 常见于 Laravel 的预发布分支
• "phpunit/phpunit": "10.5.0@alpha" —— 安装带 alpha 标签的具体版本

调整 minimum-stability（必要时）

如果项目根目录 composer.json 中已设 "minimum-stability": "stable"（默认值），而你又想装 @dev 包，有两种方式处理：

• 临时放宽：运行 composer require vendor/package:dev-main --stability=dev，无需改配置
• 永久允许：在 composer.json 中添加或修改：
  "minimum-stability": "dev",
  注意这会影响所有依赖——除非你同时用 "prefer-stable": true 来优先选 stable 版本

慎用 dev-main / dev-master

这类分支引用没有固定版本锚点，每次 composer update 都可能拉取完全不同甚至破坏性变更的代码：

标签： composer 开发版本 php laravel js git json github ai gitlab