Composer默认禁止安装dev-main等不稳定版本，因minimum-stability默认为stable，需显式加--stability=dev或@dev后缀才能成功安装，且锁定到具体commit而非分支。
直接装 dev-main 或 1.2.0-beta.1 会失败，不是因为命令写错，而是 Composer 默认屏蔽所有不稳定版本——必须显式告诉它“这次允许”。
为什么 composer require vendor/name:dev-main 直接报错
Composer 的 minimum-stability 默认是 stable，它会把 dev-main、alpha、beta 全部过滤掉，连尝试拉取都跳过。错误提示常是 Could not find package 或 Your requirements could not be resolved，而不是网络或权限问题。
- 先用
composer show vendor/name --all确认目标分支或版本真实存在（比如dev-main、v2.0.0-beta1） - 别依赖
^2.0@beta这种写法去“碰运气”——如果包本身没打beta标签，只打了v2.0.0-beta1，那必须写全"vendor/name": "2.0.0-beta1" -
@beta和@dev是后缀，不能和^混用：^2.0@beta合法，但^2.0@dev无效；dev-main@dev才是正确组合 - 私有 Git 仓库若未被 Packagist 索引，
composer require可能根本查不到分支名，此时要手动加repositories并设"type": "vcs"
composer require 加什么参数才真正生效
最安全的做法是不改全局配置，而用命令行参数临时放开限制：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 装 dev 分支：
composer require vendor/name:dev-main --stability=dev - 装 beta 版本：
composer require vendor/name:^2.0@beta --stability=beta - 参数名支持简写：
--stability-dev和--stability=dev等价，但后者更通用 - 如果已存在旧版本，
require默认只更新composer.lock，可能不重下代码——加--update-with-dependencies强制刷新依赖树 - 执行后立刻检查：
composer show vendor/name，看输出里versions行是否显示你指定的dev-main或2.0.0-beta1
composer.lock 锁的是 commit hash，不是分支名
装完 dev-main 后，composer.lock 里该包的 source 字段会是 "type": "git"，且 "reference" 是一个固定 commit hash（比如 "a1b2c3d..."），不是 main 这个字符串。
- 这意味着下次运行
composer install会严格复现这个 commit，不会自动更新到main的新提交 - 想持续跟踪分支最新提交？只能靠
composer update vendor/name，且确保远程分支 HEAD 已变 - CI 构建中若缓存了
vendor/或composer.lock，可能误用旧 commit——建议 CI 显式跑composer update --no-interaction（仅对需要的包） - 别指望
--ignore-platform-reqs解决 dev 包安装失败——那是 PHP 扩展缺失的问题，和稳定性无关
PHP 版本不兼容时，@beta 也救不了你
很多 beta 包要求更高版本的 PHP（比如 php: ^8.2），而你的项目是 ^8.1。这时即使写了 @beta，Composer 也会因平台约束拒绝安装。
- 用
composer show vendor/name 2.0.0-beta1查它的requires php字段，确认是否匹配本地环境 - 临时降级 PHP 版本约束风险极高，不如在测试环境单独验证：新建空目录，
composer init后直接require目标 beta 包 - CI 中若用了
--no-dev，而 beta 包在require-dev里（如phpunit/phpunit），它根本不会进vendor/——必须加--dev - 装完后执行失败？常见原因是入口路径不对：
./vendor/bin/phpunit是默认路径，不是全局phpunit命令
真正麻烦的不是怎么装，而是装完之后没人记得它锁死了某个 commit；等两周后 main 分支修复了关键 bug，却没人想到要 update ——这种隐性陈旧比装不上更难排查。
