Composer指定特定分支的版本约束书写方法-composer-PHP中文网

composer拉取dev分支失败主因是分支名未严格匹配远程仓库真实分支名，如dev-main实际需对应远程main分支（大小写敏感），且必须在repositories中显式声明vcs仓库并指定可clone的url。

composer指定特定分支的版本约束书写方法

dev-分支名必须完整匹配远程仓库中的真实分支名

写成 dev-main 却拉到 master，大概率是分支名不一致。Composer 不做映射或别名转换，dev-main 就只认远程 Git 仓库里叫 main 的分支（大小写敏感），不是 Master、MAIN 或 main/feature。

常见错误包括：

本地 git remote 查到的是 origin/main，但远程仓库实际默认分支是 master（GitHub 新建仓库默认 main，但老项目或自建 Git 服务可能仍是 master）
分支含斜杠，如 feature/auth，必须写成 dev-feature/auth，不能简写为 dev-auth 或 dev-feature-auth
拼写带连字符或下划线，比如 dev-user-login-v2，少一个 -v2 就失败

必须显式声明 VCS 仓库，否则仍走 Packagist

只在 require 里写 "acme/package": "dev-auth-refactor" 是不够的。Composer 默认优先查 Packagist，如果该包在 Packagist 上已注册，它会忽略你的 dev- 写法，转而安装 Packagist 上标记为 dev-auth-refactor 的最新 stable tag（往往不存在，最终 fallback 到 dev-master 或 latest stable）。

正确做法是在 composer.json 顶层加 repositories 声明：

"repositories": [
  {
    "type": "vcs",
    "url": "https://github.com/acme/package.git"
  }
]

注意：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

url 必须可直接 clone（支持 https / git@ / ssh 等格式）
不要把私有仓库配成 packagist 类型，否则无效
多个私有包需合并到同一 repositories 数组，不能重复定义 key

composer update 必须带包名 + --with-dependencies

运行 composer update 全量更新会受 lock 文件缓存影响，很可能跳过你的分支变更。最稳的方式是指定包名并强制重算依赖图：

composer update acme/package --with-dependencies

原因在于：

--with-dependencies 确保上游依赖也按新约束解析，避免因子依赖锁死旧版本导致分支被忽略
不加包名时，Composer 可能复用 lock 中已有记录，尤其当 acme/package 已存在于 vendor 且未被其他命令标记为“需更新”
如果之前装过 dev-master，lock 文件里存的是 master 分支某次 commit hash，不清理就跑 update，它不会主动换分支

dev-前缀和 #commit-hash 的行为差异很关键

dev-auth-refactor 和 dev-auth-refactor#abc1234 看似只差个哈希，但语义完全不同：

dev-auth-refactor：每次 install 或 update 都 fetch 远程该分支 HEAD，适合 CI 持续集成或开发联调
dev-auth-refactor#abc1234：固定到某次提交，但 Composer 不校验 GPG 签名，也不验证该 commit 是否还存在——如果远程 force-push 覆盖了 abc1234，下次 install 直接报 Could not find package at commit abc1234
二者都不进 composer.lock 的 dist 字段，而是走 source，所以必须确保目标机器能访问对应 Git 服务器