直接用composer require vendor/package:dev-main可拉取开发分支，而dev-master因要求远程仓库真实存在master分支（现多为main）且默认minimum-stability=stable会过滤dev-约束，常报“Could not find package”；国内镜像不代理dev分支，需切回packagist.org或配vcs源。
直接用 composer require vendor/package:dev-main 就能拉开发分支，但 dev-master 大概率失败——它不是通用别名，而是对「远程仓库是否存在 master 分支」的硬性检查；国内镜像源（如阿里云、腾讯云）默认不代理 dev- 分支，必须手动切回 packagist.org 或配 vcs 源。
为什么 dev-master 经常报 “Could not find package”
这不是网络或拼写问题，是 Composer 在解析阶段就过滤掉了：默认 minimum-stability 是 stable，所有 dev- 开头的版本约束都会被跳过，连远程仓库都不去查。更关键的是，dev-master 要求目标 Git 仓库**真实存在名为 master 的分支**。2026 年绝大多数新项目默认分支已是 main，写 dev-master 就等于让 Composer 去找一个不存在的分支。
- 先确认真实分支名：打开包的 GitHub/GitLab 页面，看顶部显示的默认分支（大概率是
main） - 或者运行
composer show vendor/package --all，看输出里列出的可用dev-分支（如dev-main、dev-next） - 别写
dev-Main或dev-main@dev—— 大小写敏感，@dev后缀在新版 Composer 中已不必要且可能干扰解析
国内镜像源不拉 dev- 分支，怎么办
阿里云、腾讯云等 Composer 镜像只同步 packagist.org 上的稳定版本（tags 和 releases），dev- 分支属于 Git 原生操作，镜像不代理、不缓存。一旦你全局配置了镜像（如 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/），执行 composer require vendor/package:dev-main 会静默 fallback 到 packagist.org，但部分旧版客户端甚至直接报错。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 临时关闭镜像：加
--no-plugins+ 显式指定源composer require vendor/package:dev-main --repository=https://packagist.org - 永久方案：删掉全局镜像配置，或只对特定包走 vcs 源（见下一条）
- 检查是否生效：装完后进
vendor/vendor/package/，运行git remote -v，输出应为origin https://github.com/vendor/package.git，而非镜像地址
私有库或未上 packagist 的包，必须配 vcs 源
如果包不在 packagist.org 上（比如公司内网 GitLab、GitHub 私有库），光写 vendor/package:dev-main 不行——Composer 根本不知道去哪里找这个仓库。必须先在项目根目录 composer.json 的 repositories 字段里声明源类型为 vcs，且 URL 必须是可 git clone 的地址。
-
repositories块示例：{ "type": "vcs", "url": "https://gitlab.example.com/team/project.git" } -
require里写法必须和仓库 URL 的 owner/name 完全一致："team/project": "dev-main"，不能写成"vendor/project" - 私有 GitLab/GitHub 需提前配好
auth.json，否则 clone 时会卡在认证环节 - 仓库根目录必须有合法的
composer.json，且其中name字段要和require中的一致（大小写敏感）
装上了，但代码不是最新的？这是锁文件在作祟
Composer 默认把 dev-main 解析成某个具体 commit hash，并记入 composer.lock。下次 composer install 完全按 lock 文件还原，哪怕远程 main 分支已推进几十个新提交，本地也不会变。
- 想强制更新到分支最新 HEAD：运行
composer update vendor/package --with-dependencies - 只想看当前装的是哪个 commit：
composer show -s vendor/package，关注source行里的reference - 如果用了
path类型 repository（比如本地开发调试），dev-main完全无效——它只是硬链接，切换分支毫无意义，必须删掉vendor/package目录再update
最麻烦的从来不是“怎么装”，而是装完之后没人检查 composer.lock 里锁的是不是你想要的 commit，也没人验证那个 commit 是否真包含你要的功能——它可能只是 CI 失败前最后一次推送的残缺代码。
