直接用composer require vendor/package:dev-branch-name可安装指定dev分支，必须加dev-前缀、大小写敏感，含斜杠分支写为dev-feature/auth；若包不在Packagist或为私有库，需先在repositories中声明VCS源。
composer require 怎么写才能装对 dev 分支
直接用 composer require vendor/package:dev-branch-name，别改 composer.json 再跑 install——它会自动写入并拉取最新提交。关键就两点：版本字符串必须以 dev- 开头，且大小写敏感（Dev-Main 无效）。
常见错误现象：composer require monolog/monolog 后发现装的是 v3.5.0，但你想用的 dev-fix-logging-context 根本没出现；或者执行 composer update 后分支被降级成 stable 版。
-
dev-是强制前缀，不能省略，也不能写成dev/branch或dev-branch/ - 分支名含斜杠（如
feature/auth）时，必须写成dev-feature/auth，不是dev-feature\auth或dev-feature//auth - 如果包不在 Packagist 注册，或分支在私有 GitLab/GitHub 上，得先在
composer.json的repositories里声明 VCS 源 - 命令行里不加引号通常也行，但版本含破折号（如
dev-9.x-rc1）建议加引号：composer require "vendor/pkg:dev-9.x-rc1"
为什么装了 dev 分支却总是拉错 commit
因为 composer update 默认会更新到该分支最新的 commit，而 composer install 只按 composer.lock 还原——如果你没锁死 reference，下次 update 就可能跳到别人刚 push 的新提交上。
常见错误现象：今天装的 dev-main 还好使，明天同事 update 一下，突然报错，查发现 vendor/ 里代码变了，composer.lock 里的 source.reference 是个新哈希。
- 想锁定具体 commit，得用
dev-main#abc123456789这种写法，abc123456789必须是main分支上的真实 commit hash -
dev-main#abc123中的dev-main只是占位符，真正起作用的是#后面的 hash；换分支名（比如dev-main改成dev-stable）不影响解析 - 若未显式指定 commit hash，又没运行过
composer update，composer install仍会还原上次lock记录的 commit，不会自动“追新” - CI 环境中务必确保
composer.lock提交进仓库，否则每次构建都可能拉不同 commit
minimum-stability 和 prefer-stable 怎么配才不拦 dev 分支
默认 minimum-stability 是 stable，这意味着即使你写了 dev-main，Composer 也会因稳定性策略拒绝安装——除非你显式放宽或覆盖。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
常见错误现象：执行 composer require vendor/pkg:dev-main 报错 Could not find a matching version，但分支明明存在、URL 也能 curl 通。
- 最轻量解法：加
--stability=dev参数，如composer require vendor/pkg:dev-main --stability=dev - 临时全局放宽：在项目根目录运行
composer config minimum-stability dev，但会降低所有依赖的安全基线 - 更推荐方式：保持
minimum-stability为stable，只对特定包用"vendor/pkg": "dev-main as 1.0.x-dev"别名，让 Composer 认为这是个“伪稳定版” -
prefer-stable: true不影响dev-显式指定，它只在版本约束模糊时（如^2.0）起作用
branch-alias 在哪写、什么时候生效
branch-alias 必须写在**被依赖包自己的 composer.json** 的 extra 字段下，不是你项目的根 composer.json。它只在你用语义化版本（如 "^2.0" 或 "2.0.x-dev"）require 时才参与解析。
常见错误现象：你在自己项目里加了 "branch-alias": {"dev-main": "2.0.x-dev"}，结果 composer require vendor/pkg:^2.0 还是装不了 dev-main；或者配置写对了，但 dev-main 分支没推送到远程，Packagist 也没索引，照样 fallback。
- 别名写错位置（比如写在根项目或顶级字段）→ 完全无效果，也不报错
- 分支名大小写敏感：
dev-Main≠dev-main，Git 仓库里实际是小写就只能配小写 - 只有当你写
"vendor/pkg": "^2.0"时，Composer 才会去查被依赖包的extra.branch-alias；写"vendor/pkg": "dev-main"就直连分支，不走别名 - 私有仓库需确保 CI 构建机有权限读取该分支，SSH key 或 token 权限不足会导致索引失败
实际操作中最容易被忽略的点是：dev 分支的 commit hash 是否真实存在于目标分支上，以及 composer.lock 是否提交——这两处出问题，本地能跑通，CI 却总失败。
