必须使用 dev- 前缀是因为 Composer 将 Git 分支映射为开发版别名而非真实版本号，仅识别 dev- 开头的伪版本标识；如分支 main 对应 dev-main，hotfix/db-timeout 对应 dev-hotfix/db-timeout。
可以直接安装 Git 分支，但必须用 dev- 前缀 + 分支名作为版本约束，否则 Composer 会报错“package not found”或“no matching package found”。
为什么必须写成 dev-branchname？
Composer 把 Git 分支映射为“开发版别名”，不是真实版本号。它不识别原始分支名（如 feature/login），只认 dev- 开头的伪版本标识。这个前缀是强制约定，不是可选项。
- 分支
main→ 对应版本dev-main - 分支
hotfix/db-timeout→ 对应版本dev-hotfix/db-timeout（注意斜杠保留） - 分支
v2.1-dev→ 对应版本dev-v2.1-dev（连字符也照常保留）
安装命令怎么写？
用 composer require 指定包名和 dev- 版本即可。不需要先 fork 或改 repositories 配置，只要目标仓库公开可访问。
composer require vendor/package-name:dev-feature/auth
如果要指定具体 Git URL（比如私有仓库或非 Packagist 上的包），才需要加 repositories：
{
"repositories": [
{
"type": "vcs",
"url": "https://gitlab.example.com/team/project.git"
}
],
"require": {
"team/project": "dev-main"
}
}
常见错误和绕过方式
错误现象：运行后提示 Could not find a version of package xxx matching your minimum-stability。
- 默认
minimum-stability是stable，而dev-开头的版本属于dev稳定性级别 → 必须显式允许："minimum-stability": "dev"，或加"prefer-stable": true保持其他包仍走 stable - 分支名含特殊字符（如
#、?）会导致 URL 解析失败 → 改用repositories+package类型手动定义，避免自动发现 -
composer update时跳过该包 → 检查是否被replace或conflict规则屏蔽，或该分支未包含合法的composer.json
最易忽略的是：分支里 composer.json 的 version 字段如果写了具体值（如 "1.2.0"），Composer 会优先按那个版本解析，而不是按 dev- 别名 —— 所以开发中建议删掉 version 字段，让它完全由分支名驱动。
