@dev是稳定性标签而非版本号，必须与分支名或dev-前缀组合使用，如"dev-main@dev"，用于绕过minimum-stability限制但不改变版本范围逻辑。
什么是@dev版本约束
@dev不是独立的版本写法，而是稳定性标签（stability flag），必须跟在包名或版本表达式后面，用来显式允许安装开发态版本。它不改变版本范围逻辑，只绕过minimum-stability默认限制。
比如"monolog/monolog": "dev-main@dev"和"monolog/monolog": "dev-main"在minimum-stability为stable时行为不同：后者会被拒绝，前者则被接受。
常见误用是把它当版本号用，比如"foo/bar": "@dev"——这语法错误，Composer会报Invalid version string "@dev"。
@dev必须搭配分支名或dev-前缀使用
正确写法只有两类：
-
"vendor/package": "dev-master@dev"（指定master分支最新提交） -
"vendor/package": "dev-feature/login@dev"（指定feature/login分支） -
"vendor/package": "1.2.x-dev@dev"（匹配带-dev后缀的标签，如1.2.0-dev）
注意：dev-master不等于master分支——Composer要求明确写dev-前缀，否则识别为普通字符串而非分支引用。
如果目标分支已废弃（如dev-master在 GitHub 上被重命名为main），composer install会失败并提示Could not find package vendor/package at version dev-master。
@dev和minimum-stability的交互关系
关键点：加了@dev只是“申请豁免”，最终是否能装，仍受config.minimum-stability和config.stability-flags共同控制。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
例如：
{
"minimum-stability": "stable",
"config": {
"stability-flags": {
"monolog/monolog": "dev"
}
},
"require": {
"monolog/monolog": "dev-main"
}
}
这段配置等价于"monolog/monolog": "dev-main@dev"，但更推荐用stability-flags——它把稳定性策略集中管理，避免每个依赖都硬编码@dev。
容易踩的坑：
- 在
minimum-stability为dev时加@dev纯属冗余，且可能干扰某些旧版 Composer 解析 -
stability-flags只对未显式指定稳定性的依赖生效；一旦写了@stable或@rc，stability-flags就失效
生产环境慎用@dev的真实原因
不是因为它“不稳定”，而是因为dev-分支没有语义化版本锚点，每次composer update都可能拉取完全不同的代码快照——哪怕只改了一行测试代码，composer.lock里的source哈希也会变，导致部署不可重现。
如果你必须用开发分支，优先考虑：
- 用
composer require vendor/package:dev-main --prefer-source确保本地有完整 Git 历史，方便排查 - 在
composer.json中补上"prefer-stable": true，让 Composer 在满足@dev前提下，仍优先选该分支里最新的稳定标签（如果有） - 定期将
dev-main对应的提交打上v1.5.0-alpha这类带语义的预发布标签，逐步过渡到^1.5约束
真正难处理的从来不是语法，而是分支生命周期和团队协作节奏——@dev只是把这个问题提前暴露出来。
