指定 Git 分支需写为 dev-分支名，如 dev-main 或 "dev-feature/login-v2"；分支名须与远程仓库完全一致（区分大小写），私有仓库需在 repositories 中声明；分支依赖不锁定 commit，适合开发但不宜用于生产。
composer require 怎么指定 Git 分支
直接在包名后加 dev-分支名 即可，Composer 会自动从 Git 仓库拉取对应分支的代码。这不是“hack”，是官方支持的标准写法。
常见错误是写成 dev/master 却忘了仓库默认分支其实是 main，结果报错 Could not find package xxx at version dev-master。
- 分支名必须和远程仓库里真实存在的分支完全一致（区分大小写），比如 GitHub 新仓库默认是
main，不是master - 如果分支含斜杠（如
feature/login-v2），必须用引号包裹整个版本号："dev-feature/login-v2" - 不建议省略
dev-前缀——写成feature/login-v2可能被误判为版本约束，导致解析失败
composer.json 里怎么写分支依赖
在 require 或 require-dev 中，把版本号设为 "dev-xxx" 形式，和命令行一致，但要注意 JSON 格式要求双引号。
示例：
"monolog/monolog": "dev-main"表示安装
monolog/monolog 的 main 分支最新提交。
- 分支依赖不会锁定 commit hash，每次
composer install都可能拉到新提交，不适合生产环境直接使用 - 如果想固定到某次提交，改用
"dev-main#abc1234"（#后接 commit hash） - 私有 Git 仓库需提前在
repositories中声明类型为vcs，否则 Composer 找不到源
为什么 composer install 报错 “no matching package found”
绝大多数情况是分支名拼错、仓库不可达，或包未公开（私有仓库没配 repositories）。
典型错误信息：Could not find a version of package vendor/name matching your minimum-stability.
- 检查分支是否存在：手动打开 GitHub/GitLab 页面确认 URL 路径下的分支名是否准确
- 检查稳定性设置：分支版本默认是
dev稳定性，若minimum-stability设为stable，必须显式加"prefer-stable": true或在包版本后加@dev，例如"dev-main@dev" - 私有仓库要确保 SSH key 或 token 已配置，且
git clone命令能手动成功
dev 分支 vs tag 版本：性能与协作影响
用 dev-xxx 安装，Composer 每次都会执行 git clone --no-checkout + git checkout，比安装 tagged 版本慢不少，尤其大仓库。
更关键的是：分支内容不固定，不同人 composer install 可能装到不同 commit，CI 构建结果不稳定。
- 开发联调时用分支没问题，但上线前务必切回语义化版本（如
^2.5）或锁定 commit - 团队内共享 dev 分支依赖时，建议在
composer.lock提交并定期更新，避免本地缓存导致行为不一致 - 不要在
require里混用dev-和^x.y——Composer 会尝试满足所有约束，容易触发不可解的依赖冲突
分支依赖看着灵活，实际对 lock 文件、CI 缓存、团队同步都提了更高要求，不是“多打几个字”那么简单。
