Composer识别dev-开头的版本号需写为dev-main、dev-develop等完整分支名，不能写dev-1.2.3；必须配合repositories正确配置VCS源，且分支名须与远程仓库严格一致。
dev- 开头的版本号怎么写才被识别
Composer 会把 dev- 开头的字符串当作开发分支别名处理，而不是真实版本号。比如 dev-main、dev-develop、dev-feature/login 都合法，但 dev-1.2.3 不行——它不会匹配任何 tag，安装时大概率报 Could not find package ... at version dev-1.2.3。
正确做法是直接用分支名，不加 v 前缀、不混用语义化版本格式：
-
composer require vendor/package:dev-main→ 拉取 main 分支最新 commit -
composer require vendor/package:dev-feature#abc123→ 指定分支 + 提交哈希（需配置私有源或 GitHub repo） - 在
composer.json中写"vendor/package": "dev-main"，不是"dev-main as 1.0.0"（后者仅用于replace场景）
使用 @dev 或 @stable 后缀的实际效果
后缀如 @dev 是稳定性标识符，不是版本约束的一部分。它只影响 Composer 是否跳过稳定性检查，不改变解析逻辑。
例如 "monolog/monolog": "2.9.*@dev" 的含义是：“接受所有 2.9.x 的 tag，且允许安装其中标记为 dev 稳定性级别的版本”——但 2.9.x 系列的正式版都是 stable，所以这个 @dev 实际上没作用，还可能误导自己。
真正需要 @dev 的典型场景只有两个：
- 你明确要装一个带
dev-前缀的分支，又怕被 stability 设置拦住（比如项目设了"minimum-stability": "stable"），这时加@dev是绕过手段 - 某个包只发布了
alpha/beta标签，而你又没调低minimum-stability，就得写成"package": "1.0.0-beta.1@beta"
如何安全地引用未打 tag 的 GitHub 分支
直接写 dev-xxx 有时会失败，尤其当包没在 Packagist 注册，或仓库未配置为 VCS 类型源时。关键在于让 Composer 能定位到代码源头。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
必须确认三点：
- 你的
composer.json中已声明repositories，类型为vcs，URL 指向对应 GitHub 仓库（注意不是 HTTPS 页面 URL，而是 Git 协议或 SSH 地址） - 分支名拼写完全一致，区分大小写；GitHub 上的
main和master是不同分支 - 如果要用特定 commit，得用
dev-branch-name#commit-hash格式，不能省略dev-前缀
示例有效配置：
{
"repositories": [
{
"type": "vcs",
"url": "https://github.com/vendor/package.git"
}
],
"require": {
"vendor/package": "dev-main"
}
}
为什么 composer show --all 不显示 dev 分支
composer show --all vendor/package 只列出该包在 Packagist 上注册的 tag 和稳定分支（如 dev-main 若被显式标记为“default branch”才会出现）。它不扫描远程 Git 仓库实时状态。
如果你改了 GitHub 上的 main 分支但 show --all 没刷新，说明 Packagist 还没同步——这很常见。此时不要依赖 show 判断可用分支，改用：
-
git ls-remote https://github.com/vendor/package.git直接查远程 ref - 或者临时加
"minimum-stability": "dev"+"prefer-stable": false，再跑composer update --dry-run看能否解析
最易被忽略的一点：Composer 对 dev- 分支的解析高度依赖源配置和网络可达性，本地缓存或防火墙拦截会导致行为不一致，调试时优先 composer clear-cache。
