Composer怎么下载处于开发中的分支？dev-master与镜像【实战】-composer-PHP中文网

直接用composer require vendor/package:dev-main可拉取开发分支，而dev-master因要求远程仓库真实存在master分支（现多为main）且默认minimum-stability=stable会过滤dev-约束，常报“could not find package”；国内镜像不代理dev分支，需切回packagist.org或配vcs源。

composer怎么下载处于开发中的分支？dev-master与镜像【实战】

直接用 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 Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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