直接写composer require vendor/name:dev-main即可安装main分支，但必须带dev-前缀、大小写敏感且分支须真实存在；私有包需先配置repositories，否则无法解析。
composer require 怎么写才能装上 dev 分支
直接运行 composer require vendor/name:dev-main 就能装 main 分支，但必须带 dev- 前缀；不加就报 Could not find package 或当成错误版本号去 Packagist 查。分支名大小写敏感，dev-main 和 dev-Main 是两个东西。
常见错误写法：vendor/name:main、vendor/name:#main、vendor/name:feature/login——这些都没 dev-，Composer 一律解析失败。
-
dev-main、dev-develop是常规写法 - 含斜杠分支（如
feature/login）必须写成dev-feature/login，不能 URL 编码（那是旧版坑，2026 年起 Composer 已原生支持） - 私有仓库或非 Packagist 托管的项目，
require命令本身不自动识别源，得先配repositories
为什么加了 dev- 还是找不到包
最常见原因是 Composer 没找到 Git 仓库入口。它默认只查 Packagist，如果你的包不在上面，或你想用 fork 替换官方源，就必须手动声明 repositories：
在 composer.json 里加：
{
"repositories": [
{
"type": "vcs",
"url": "https://github.com/yourname/package.git"
}
]
}
注意：url 必须是完整 Git 地址；type 必须是 vcs；require 中的包名仍用原始名（比如 monolog/monolog），不是你 fork 的用户名。
- 私有仓库要提前配好 SSH key 或 GitHub token，否则
composer install卡在认证 - 如果仓库里没有
composer.json，或者name字段和你在require里写的不一致，也会失败 - 执行
composer clear-cache再试，有时旧缓存会干扰解析
装上了，但不是最新 commit 怎么办
因为 dev- 版本默认走 dist 缓存，不会每次都 fetch HEAD。哪怕你删了 vendor 重装，也可能复用旧 commit hash。
强制拉最新代码的方法只有两个：
- 加
--no-cache：运行composer require vendor/name:dev-main --no-cache - 改
composer.json后用composer update vendor/name——update 默认绕过部分缓存，比 require 更可靠
验证是否真拉到最新：git -C vendor/vendor/name log -1 或看 composer show vendor/name 输出里的 source 行。
minimum-stability 需不需要改
不一定。如果项目根 composer.json 的 minimum-stability 是 stable，而你又没在 require 里显式写 dev-，就会报错 Could not find a version... matching your minimum-stability。
解决方式有两个方向：
- 临时放宽：运行
composer require vendor/name:dev-main --with-all-dependencies，它会自动处理依赖兼容性 - 长期配置：在
composer.json里加"prefer-stable": true（推荐），而不是改minimum-stability，避免意外装进其他不稳定的包
真正容易被忽略的是：分支存在性检查只发生在第一次解析时，后续 update 不会重新校验远程分支是否还存在——删了分支再 update 可能静默失败或卡住。
