Composer 默认不支持直接拉取私有仓库非默认分支，需在 composer.json 中显式配置 type 为 "vcs" 的 repositories 并确保分支存在、含有效 composer.json 且 name 匹配。
Composer 默认不支持直接通过 composer require 拉取私有仓库的非默认分支（比如 dev-feature/login），必须显式配置 repositories 并声明 version 为对应的开发版本别名。
为什么 composer require vendor/package:dev-branch-name 常常失败
私有 Git 仓库（如 GitHub/GitLab/自建 Gitea）未在 composer.json 中声明 repositories，Composer 就无法识别该包来源；即使加了，若未启用 allow-plugins 或未设置 type: "vcs"，Composer 会跳过解析，报错 Could not find a matching version of package vendor/package。
- 私有仓库需在
repositories中明确定义，且type必须为"vcs"（不是"package"或"path"） -
dev-开头的分支名会被 Composer 自动映射为开发版版本号，但前提是该分支存在且可被 VCS 驱动探测到 - GitLab 私有实例若启用了 2FA 或 IP 白名单，还需确保 Composer 使用的 token 有足够权限（
read_repository）
正确配置 repositories 并拉取指定分支
在项目根目录的 composer.json 中添加 repositories 块，指向仓库地址，并用 composer require 显式指定开发版本别名：
{
"repositories": [
{
"type": "vcs",
"url": "https://gitlab.example.com/team/project.git"
}
],
"require": {}
}
然后运行：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer require vendor/project:dev-main
或（如果分支名为 feature/auth）：
composer require vendor/project:dev-feature/auth
- 分支名中的
/不需要 URL 编码，Composer 内部会自动处理 - 不要写成
dev/feature/auth或feature/auth—— 必须是dev-feature/auth格式 - 如果仓库未设置
"default-branch"，首次 fetch 可能较慢，因 Composer 要扫描所有分支来匹配dev-前缀
使用 composer config 全局注册私有仓库（避免重复配置）
适合团队内多个项目共用同一私有源，用 composer config 写入全局或项目级配置：
composer config repositories.my-private-vcs '{"type":"vcs","url":"https://gitlab.example.com/team/project.git"}'
之后即可直接 composer require vendor/project:dev-fix/cache，无需每次改 composer.json。
- 该命令修改的是当前项目的
composer.json（加--global才写入全局auth.json同级配置） - 注意：全局配置不能替代项目级
repositories，因为repositories是包发现机制的一部分，必须出现在项目composer.json或其继承链中 - 如果执行后仍找不到包，运行
composer clear-cache再试 —— Composer 会缓存 VCS 元数据，旧缓存可能导致分支不可见
真正容易被忽略的是：私有仓库的分支必须有至少一个带 composer.json 的提交，且该文件中 "name" 字段必须与 require 中的 vendor/package 完全一致（包括大小写）。少一个字母或换行符差异，都会导致“版本不存在”。
