composer require 可直接通过#分支名或dev-前缀指定Git分支安装，支持HTTPS/Git协议URL及私有仓库，需配置repositories为vcs类型并设minimum-stability为dev。
composer require 怎么指定 Git 分支安装
直接在 composer require 命令里加 #分支名 就行，Composer 会自动识别为 VCS 源并拉取对应分支的代码。不需要提前配置仓库或改 composer.json。
常见错误是写成 vendor/package#dev-feature-branch 却没加 dev- 前缀，或者误以为必须用 git@ 地址——其实 HTTPS 地址（如 https://github.com/vendor/repo）同样支持分支后缀。
-
composer require monolog/monolog:dev-main—— 安装 main 分支（注意dev-前缀是必需的） -
composer require "phpunit/phpunit:dev-feature/my-test#9a3b1c2"—— 指定分支 + 提交哈希 - 如果包不在 Packagist 上，但 GitHub 公开可访问，直接写 URL：
composer require "https://github.com/myorg/mylib.git#develop"
composer.json 里怎么写 dev 分支依赖
在 composer.json 的 require 字段中，版本号写成 dev-分支名 格式，Composer 就会从源码仓库拉取该分支的最新提交，而不是打过 tag 的稳定版。
注意：分支名里的斜杠（/）、下划线（_）等特殊字符要原样保留，但不能包含空格；且必须确保该分支在远程仓库真实存在，否则 composer install 会报 Could not find package ... matching your minimum-stability 错误。
{
"require": {
"symfony/console": "^6.4",
"mycompany/internal-tool": "dev-release/2.3"
},
"minimum-stability": "dev",
"prefer-stable": true
}
-
minimum-stability设为dev是关键，否则dev-开头的版本会被忽略 -
prefer-stable: true可以让其他包仍优先选 stable 版本，避免全项目降级到不稳定状态 - 分支名不区分大小写，但建议和远程仓库保持一致（GitHub 默认是
main或master）
安装时提示 “Could not load package” 或 “No matching package found”
这类错误通常不是语法问题，而是 Composer 没法解析目标分支的元数据——尤其当你用的是私有仓库、自建 Git 服务，或分支尚未被 Packagist 索引时。
解决方法是显式声明仓库类型，强制 Composer 走 VCS 模式：
- 在
composer.json中添加repositories字段，明确指定type: "vcs"和仓库地址 - 地址必须是可 git clone 的 URL（支持
https://、git@、ssh://） - 不要写错协议或路径，比如
git@github.com:user/repo缺少.git后缀可能失败
{
"repositories": [
{
"type": "vcs",
"url": "https://github.com/myorg/private-lib.git"
}
],
"require": {
"myorg/private-lib": "dev-fix/auth-header"
}
}
dev 分支安装后为什么 vendor 里看不到 .git 目录
默认情况下，Composer 用 git clone --depth=1 --no-hardlinks 拉取，只保留工作区文件，不带 Git 历史。这节省空间也加快安装，但会导致你无法在 vendor/ 里执行 git pull 或切分支。
如果确实需要完整 Git 信息（例如本地调试、提交 patch），得手动启用 --prefer-source：
composer require mypackage/dev-feature --prefer-source- 或全局配置：
composer config --global prefer-source true - 注意：启用后每次更新都会重新 clone，占用更多磁盘和网络，CI 环境一般应禁用
另外，composer update 默认不会自动升级 dev 分支到最新 commit，除非你删掉 composer.lock 或加 --with-dependencies 显式刷新。
