Composer 默认只装 stable 版本，安装 dev-main 等需显式设 --stability=dev 或用 @ 标签；预发布版须带 @beta 等后缀；GitHub 未发布包需添加 vcs 仓库源。
安装 dev-main 或 dev-develop 版本时，composer require 为什么报错“could not find package”
因为 Composer 默认只允许安装 stable（稳定）版本，而 dev-main、dev-develop 这类开发分支名不是 Packagist 上正式发布的版本号，必须显式告诉 Composer：允许降级稳定性。
- 直接运行
composer require vendor/name:dev-main会失败，除非包已声明支持该分支或你已配置最低稳定性 - 正确做法是加
--stability=dev参数：composer require vendor/name:dev-main --stability=dev - 或者在
composer.json中全局设置："minimum-stability": "dev"，但不推荐——它会影响所有依赖，可能拉进一堆不稳定的代码 - 更安全的做法是只对单个包指定稳定性：
composer require vendor/name:dev-main --stability-dev（注意是--stability-dev，不是--stability=dev，两者等价但后者更常见）
安装 alpha/beta/rc 版本时，composer install 卡住或跳过安装
Composer 对 alpha、beta、rc 等预发布版本有默认稳定性约束，即使你在 require 里写了 "^2.0@beta"，如果项目 minimum-stability 是 stable，它仍会忽略。
- 写法必须带 @ 符号和稳定性标签：
"vendor/name": "^2.0@beta"，不能只写"^2.0"再靠配置兜底 - 如果包本身没打
beta标签（比如只打了v2.0.0-beta1），那得用完整版本号："vendor/name": "2.0.0-beta1" -
composer update vendor/name比install更可靠——因为install只读composer.lock，而 lock 文件里可能根本没存这个 beta 版本 - 检查是否真装上了：运行
composer show vendor/name，看输出里的versions行有没有显示你想要的2.0.0-beta1或dev-main
minimum-stability 和 prefer-stable 一起用时，实际行为很反直觉
这两个配置组合起来，会让 Composer 在“想装稳定版”和“不得不装不稳定版”之间反复横跳，尤其当你 require 的包依赖另一个不稳定包时。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
"minimum-stability": "dev"+"prefer-stable": true的意思是：“优先选 stable，但允许 fallback 到 dev”——听起来合理，但实际会强制所有包都尽量找 stable 版本，哪怕你明确写了dev-main - 真正生效的组合是：
"minimum-stability": "dev"且去掉prefer-stable，或设为false - 最干净的做法：不改全局配置，只对特定包用
@后缀指定稳定性，例如："vendor/name": "dev-main as 1.0.0"（as 是别名，用于满足版本约束） - 修改后务必删掉
composer.lock和vendor/重装，否则旧 lock 文件会锁死旧行为
从 GitHub 直接安装未发布到 Packagist 的分支或提交
有些包还没提交到 Packagist，或者你想试一个 PR 分支，这时得手动加仓库源，否则 Composer 根本找不到。
- 先在
composer.json的repositories数组里加一条：{"type": "vcs", "url": "https://github.com/vendor/name"} - 然后运行
composer require vendor/name:dev-feature-branch（分支名要真实存在） - 如果只想装某个 commit，用
dev-main#abc1234格式，其中abc1234是 short commit hash - 注意：GitHub 私有库需要提前配好
auth.json，否则会卡在认证环节，错误信息通常是Could not fetch https://api.github.com/... - 临时测试完建议删掉
repositories条目，避免后续误影响其他依赖解析
稳定性标记本质是 Composer 的版本过滤器，不是“开关”。它不改变包内容，只决定哪些版本号能被选中——所以最常出问题的地方，其实是你以为写了 @beta 就够了，却忽略了 minimum-stability 的全局压制，或者忘了 composer.lock 里还躺着上一次的稳定版记录。
