必须加 -s dev 参数，因 Composer 默认 minimum-stability: stable，不解析 dev- 开头的开发版；私有仓库需在 repositories 中声明 type: "vcs"；分支含斜杠须用双引号包裹；生产环境应锁定 dev-branch#commit-hash。
直接用 composer require vendor/name:dev-branch 就能克隆指定分支，但必须加 -s dev 参数，否则大概率报错“Could not find package”。
为什么 composer require vendor/name:dev-main 会失败
Composer 默认只搜 stable 包，dev- 开头的版本号被归类为开发版，不满足默认的 minimum-stability: stable 策略。不加 -s dev，它根本不会去解析该分支是否存在。
-
composer require monolog/monolog:dev-main→ 报错：no matching package found -
composer require monolog/monolog:dev-main -s dev→ 成功拉取 main 分支最新 commit - 加了
-s dev不会改你项目的composer.json里的minimum-stability，只是本次临时允许匹配 dev 版本
分支名含斜杠（如 feature/login）怎么写
斜杠必须保留，但整个版本字符串得用双引号包裹，否则 shell 或 JSON 解析会出错。
- 错误写法：
composer require vendor/name:dev-feature/login（bash 把/当路径分隔符，或 composer 解析失败） - 正确写法：
composer require "vendor/name:dev-feature/login" -s dev - 如果写在
composer.json的require里，也要加引号："vendor/name": "dev-feature/login"
私有仓库或非 Packagist 包怎么装指定分支
Packagist 上没注册的包，Composer 不知道从哪拉，必须先声明 repositories 源，且 type 必须是 vcs。
- 先在项目
composer.json里加：
{
"repositories": [
{
"type": "vcs",
"url": "https://gitlab.example.com/team/internal-package.git"
}
]
}
composer require "team/internal-package:dev-fix/auth" -s dev
composer.json，且其中 name 字段和 require 时写的完全一致（包括大小写）git@gitlab.example.com:team/internal-package.git），需配置好 SSH key 或 auth.json
装完发现还是旧 commit？怎么强制更新到分支最新
composer install 完全按 composer.lock 还原，哪怕 composer.json 已改成 dev-main，只要 lock 没更新，就还是上次的 commit。
- 删掉
composer.lock和vendor/后重跑composer install—— 彻底但重 - 更常用：
composer update vendor/name --with-all-dependencies（只更新该包及其依赖） - 加
--prefer-source强制走 git clone 而非 zip 下载，后续可进vendor/vendor/name直接git pull - 验证是否生效：
composer show vendor/name看source行，或git -C vendor/vendor/name log -1 --oneline
最易忽略的是：分支是浮动的，dev-main 今天装的是 commit A，明天别人 push 新提交后，再 composer update 就可能变成 commit B——生产环境务必用 dev-main#abc1234 锁定具体哈希。
