<p>Composer 默认拒绝安装 dev- 分支，需加 -s dev 参数；应确认真实默认分支（如 main）而非硬套 dev-master；必须用 # 锁定 commit hash 保证可重现；私有包还需在 composer.json 中配置 repositories。</p>
直接运行 composer require vendor/package:dev-master 大概率失败，不是命令写错了，而是 Composer 默认拒绝安装任何 dev- 开头的分支。
为什么 composer require vendor/package:dev-master 总报 “Could not find package”
这不是网络或包名问题，而是 Composer 的稳定性策略在起作用：minimum-stability 默认是 stable，所有带 dev- 前缀的引用（包括 dev-master）都会被过滤掉。它根本不会去查这个分支是否存在，直接跳过。
常见错误现象：
Could not find package vendor/package at version dev-masterNo matching package found for vendor/package:dev-master- 明明 GitHub 上有
master分支，但 Composer 就是不认
真正要装，必须显式告诉 Composer：“这次允许不稳定”。最安全的做法是加 -s dev 参数：
composer require vendor/package:dev-master -s dev
注意：-s dev 只影响本次命令的解析逻辑，不会改你 composer.json 里的 minimum-stability。
dev-master 已过时，优先查清真实默认分支名
很多项目早在 2020 年后就把默认分支从 master 改成了 main，但 dev-master 还会固执地去找 master —— 找不到就报错，而不是自动 fallback 到 main。
正确做法是先确认目标包的真实分支名：
- 打开包的 GitHub/GitLab 页面，看顶部显示的默认分支名（大概率是
main） - 运行
composer show vendor/package --all，看输出里列出的可用dev-分支（如dev-main、dev-develop）
然后换用对应分支：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer require vendor/package:dev-main -s dev
别硬套 dev-master，大小写和分支名必须完全一致，dev-Main 或 dev-main 写错一个字母都不行。
装上了也不代表稳了：必须锁定 commit hash
dev-main 或 dev-master 是浮动引用，每次 composer update 都可能拉到新提交，CI 构建结果不可重现，线上行为随时突变。
真正可控的方式是加 # 后缀锁定具体提交：
-
composer require vendor/package:dev-main#abc1234（短哈希，需确保该 commit 真实存在） -
composer require vendor/package:dev-main#7f8a1a2c9d0e3b4f5a6c7d8e9f0a1b2c3d4e5f6（长哈希更保险）
这样装出来的版本会记录在 composer.lock 中，下次 install 一定还原同一份代码。没加 # 的 dev-main，本质上和裸用 dev-master 一样危险。
私有仓库或非 Packagist 包必须配 repositories
如果包不在 Packagist 上（比如公司 GitLab 私有库），只写 composer require vendor/package:dev-main -s dev 依然会失败，因为 Composer 不知道去哪里找这个仓库。
必须先在根目录 composer.json 的 repositories 字段声明源：
{
"repositories": [
{
"type": "vcs",
"url": "https://gitlab.example.com/vendor/package.git"
}
]
}
注意：type 必须是 vcs，不能是 package 或漏写；url 要能被 Composer 直接 clone（需配置好 SSH key 或 token）；改完后才能执行 require 命令。
最后提醒一句：哪怕所有步骤都对了，dev- 分支的代码也可能没有类型声明、依赖 PHP 8.3、或者删掉了你正在用的类——composer require 成功只是开始，不是结束。
