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 导致分支不可见

# js  # 找不到  # 是因为  # 不支持  # 它只  # 是个  # 也会  # 下划线  # 它是  # 自动识别  # ssh  # https  # 字符串  # git  # json  # composer  # github  # ai  # gitlab  # gitee  # 为什么  # require  # 仍是