composer指定分支需用dev-前缀（如dev-main），分支名须与远程仓库完全一致且区分大小写；安装后锁定到commit hash，更新需composer update或--prefer-source配合git pull。
composer require 怎么指定分支而不是版本号
直接写分支名就行，Composer 会自动识别为 dev- 前缀的开发版约束。但要注意：分支名必须存在于目标仓库的 Git 远程（如 GitHub/GitLab），且包的 composer.json 中需声明 "minimum-stability": "dev" 或在根项目中显式配置。
常见错误现象：Could not find package vendor/name at version dev-main——多半是远程仓库没这个分支，或拼写大小写不一致（Git 分支名区分大小写）。
- 用
composer require vendor/name:dev-main安装 main 分支 - 用
composer require vendor/name:dev-develop安装 develop 分支 - 如果分支名含斜杠（如
feature/login），必须写成dev-feature/login（Composer 强制加dev-前缀） - 不建议省略
dev-前缀，composer require vendor/name:feature/login会被当成版本号解析，大概率报错
为什么 require dev-xxx 后安装的是 commit hash 而不是分支名
这是 Composer 的正常行为。它把分支映射为“不稳定版本”，实际安装时锁定到当前 HEAD 的 commit hash，以保证可重现性。你看到的 vendor/composer/installed.json 里记录的是具体 commit，不是分支名。
这意味着：分支后续有新提交，composer install 不会自动更新——除非你主动运行 composer update vendor/name 或删掉 vendor 和 composer.lock 重装。
- 想让 CI/CD 每次都拉最新代码？得配
"prefer-stable": false+"minimum-stability": "dev"，再加--prefer-source参数 -
--prefer-dist（默认）走 zip 包，无法跟踪分支变动；--prefer-source克隆完整 Git 仓库，支持后续git pull - 分支更新后，
composer show vendor/name显示的仍是旧 commit，得composer update才刷新
如何让 composer install 时始终拉取分支最新提交
不能靠 require 一行解决，得组合配置和命令。核心是放弃“版本锁定”逻辑，改用源码模式 + 强制刷新。
使用场景：本地开发调试、CI 构建临时集成环境、不想发版就试功能。
- 在项目根目录
composer.json加上："minimum-stability": "dev",<br>"prefer-stable": false
- 执行
composer require vendor/name:dev-main --prefer-source - 之后每次更新，运行
composer update vendor/name --with-dependencies --no-install，再进vendor/name目录手动git pull - 或者更暴力：删掉
vendor/name，再跑composer install --prefer-source
用 repository 自定义 Git 地址时 branch 写法容易踩的坑
自定义 repository 是绕过 Packagist、直连私有仓库的常用做法，但 branch 名必须和 Git 远程完全一致，且 type 必须是 vcs。
典型错误："reference": "main" 写成 "branch": "main"（Composer 不认 branch 字段），或漏掉 "type": "vcs" 导致 Composer 忽略该仓库。
- 正确写法示例：
{<br> "type": "vcs",<br> "url": "https://github.com/vendor/name"<br>}，然后require仍用dev-main -
"reference"字段可用于固定到某 commit，但一旦写了，就不再跟踪分支更新——它优先级高于 branch - 私有 GitLab 仓库要确保 Composer 能访问（如配好
auth.json），否则composer update卡在 clone 阶段，报错类似Failed to clone https://xxx, could not read from remote repository
