composer 找不到 dev- 开头的分支，是因为未在 composer.json 中声明 type: “vcs” 的 repositories；需用 git ls-remote 验证分支存在，且 dev-feature/login 必须与远程分支名（如 feature/login）完全一致，区分大小写和符号。
Composer 找不到 dev- 开头的分支名？先确认它是不是真存在
Composer 默认不自动识别远程 Git 分支为可安装版本，除非该分支在 composer.json 的 repositories 中被显式声明，或包本身已发布到 Packagist 并配置了分支别名。直接写 "vendor/package": "dev-feature/login" 失败，大概率是因为 Composer 根本没“看见”这个分支。
- 用
git ls-remote --heads https://github.com/vendor/package.git检查远程仓库是否真有feature/login分支（注意：不带dev-前缀） - 如果分支存在但仍是 404，说明未启用
composer.json中的package类型仓库，或未设置type: "vcs" -
dev-是 Composer 的“伪版本前缀”，它只对本地路径仓库或已配置的 VCS 仓库生效，不是 Git 分支名的一部分
正确声明 VCS 仓库并让 dev- 生效
必须在项目根目录的 composer.json 中添加 repositories，且类型为 vcs，否则 Composer 不会去 Git 仓库拉分支信息。
{ "repositories": [ { "type": "vcs", "url": "https://github.com/vendor/package.git" } ], "require": { "vendor/package": "dev-feature/login" } }-
url必须是可直接git clone的地址（支持 HTTPS / ssh / Git 协议） -
dev-feature/login中的feature/login必须与远程分支名完全一致（区分大小写、斜杠） - 不要加
^、~或其他约束符——dev-分支版本不支持语义化比较 - 执行
composer update vendor/package前，建议先运行composer clear-cache，避免旧元数据干扰
分支名含特殊字符（如 /、.）时的写法差异
Composer 对分支名中斜杠的处理很严格：dev-feature/login 可以，但 dev-feature.v1 会被当作字面量匹配，若远程分支叫 feature.v1，则必须写成 dev-feature.v1；而 dev-main 对应 main 分支，dev-master 已在 Composer 2.2+ 中被弃用，优先用 dev-main。
- 分支名含点号（
.）：直接照写，如"dev-release.2.1"→ 远程分支名必须是release.2.1 - 分支名含下划线（
_）或连字符（-）：无特殊转义，按原样写 - 分支名为
HEAD或origin/main等引用：不支持，Composer 只认真实存在的远程分支名 - 想强制指定某次提交？用
dev-feature/login#commit-hash，但需确保该 commit 在目标分支上
为什么 composer require 直接加 dev- 常失败
因为 composer require vendor/package:dev-feature/login 不会自动补全仓库配置——它只查 Packagist，而 Packagist 不索引未发布的分支。错误提示类似 Could not find package vendor/package at version dev-feature/login，本质是“没找到元数据”，不是“找不到代码”。
- 解决办法只有两个：提前在
composer.json中配好repositories，或先用composer config repositories.repo-name vcs https://...添加临时仓库 -
composer show vendor/package能列出所有可用版本（含dev-），前提是仓库已正确定义并缓存更新过 - 私有 gitlab/gitee 仓库要额外配置
auth.json，否则即使 URL 正确也会因 401 导致分支不可见
分支名拼写、仓库类型声明、缓存状态——这三个点漏掉任意一个，dev- 就只是个无效字符串。