如何使用Composer安装特定的Git分支代码
composer require 怎么写才能装上 dev 分支
想直接安装 main 分支的代码？命令其实很简单：composer require vendor/name:dev-main。这里的关键在于那个 dev- 前缀，少了它可不行。如果不加，Composer 要么报错 Could not find package，要么会误以为这是个版本号，转而跑去 Packagist 上查找，结果自然是找不到。
另外，分支名是大小写敏感的，dev-main 和 dev-Main 在 Composer 眼里完全是两个不同的东西，这点务必留意。
日常开发中，下面几种写法都是错的，因为它们都漏掉了 dev- 前缀：
vendor/name:mainvendor/name:#mainvendor/name:feature/login
记住几个要点：
- 常规分支，像
dev-main、dev-develop，直接按这个格式写就行。 - 如果分支名里包含斜杠（比如
feature/login），必须完整写成dev-feature/login。不用担心，从2026年左右开始，Composer 已经原生支持这种写法，不再需要像旧版本那样进行 URL 编码了。 - 最后，对于私有仓库或者没有发布到 Packagist 的项目，光靠
require命令是不够的，必须先在配置里声明好代码仓库源。
为什么加了 dev- 还是找不到包
命令格式对了，但依然提示找不到包？这十有八九是因为 Composer 找不到 Git 仓库的入口。默认情况下，Composer 只会去 Packagist 官方仓库查找。如果你的包不在上面，或者你想用自己的 fork 仓库替代官方源，那就必须手动配置 repositories。
具体操作是，在你的项目 composer.json 文件里添加如下配置：
{
"repositories": [
{
"type": "vcs",
"url": "https://github.com/yourname/package.git"
}
]
}
这里有三个细节需要敲黑板：
url字段必须填写完整的 Git 仓库地址。type字段必须是vcs。- 在
require语句里，使用的包名仍然是原始名称（例如monolog/monolog），而不是你 fork 后的用户名。
除此之外，还有一些常见的“坑”需要注意：
- 如果是私有仓库，请确保提前配置好了 SSH 密钥或 GitHub Token 等认证信息，否则
composer install时会卡在认证环节。 - 如果目标仓库里根本没有
composer.json文件，或者文件中的name字段与你require里写的不一致，安装也会失败。 - 当遇到一些玄学问题时，不妨试试运行
composer clear-cache清理缓存，有时候旧的缓存数据会干扰解析过程。
装上了，但不是最新 commit 怎么办
成功安装后，发现代码并不是仓库里最新的提交？别急，这不是你的错觉。因为使用 dev- 分支版本时，Composer 默认会使用 dist 缓存，它不会每次都去抓取最新的 HEAD。换句话说，即使你删除了 vendor 目录重新安装，也可能复用的是旧的 commit hash。
要想强制拉取最新代码，可靠的方法只有两个：
- 在
require命令后加上--no-cache选项：composer require vendor/name:dev-main --no-cache。 - 或者，直接在
composer.json中修改版本约束，然后使用composer update vendor/name命令。通常，update命令会比require更可靠地绕过部分缓存。
如何验证是否真的拉取到了最新代码呢？有两个方法：进入 vendor 目录下的对应包路径，执行 git log -1；或者直接运行 composer show vendor/name，查看输出信息中的 source 那一行。
minimum-stability 需不需要改
这得看情况。如果你的项目根目录下的 composer.json 中，minimum-stability 设置的是 stable（这是默认值），而你在 require 时又没有显式地写上 dev- 前缀，那么 Composer 就会报错：Could not find a version... matching your minimum-stability。
解决这个问题，通常有两个思路：
- 临时方案：在运行
require命令时，加上--with-all-dependencies参数，例如composer require vendor/name:dev-main --with-all-dependencies。Composer 会自动处理依赖的兼容性问题。 - 长期配置：在
composer.json中添加"prefer-stable": true配置。这通常是更推荐的做法，因为它表示“优先使用稳定版”，而不是直接降低整个项目的稳定性要求（minimum-stability），这样可以避免意外引入其他不稳定的依赖包。
最后，还有一个非常容易被忽略的细节：Composer 只在第一次解析依赖时，会检查远程分支是否存在。之后的 update 操作并不会重新校验。这意味着，如果你在远程仓库删除了某个分支，再次执行 update 时，可能会静默失败或者直接卡住，这一点需要特别警惕。
