Composer 不提供独立切换分支命令，所有操作均需通过 require 或 create-project 显式指定带 dev- 前缀的版本约束；漏写 dev- 是 90% 报错主因，如 composer require vendor/package:main 会因 main 非稳定版本且无 dev- 前缀而失败，正确写法为 dev-main，并常需配合 --stability=dev 参数。
Composer 本身不提供“切换分支”的独立命令，所有分支操作都依赖 require 或 create-project 时显式指定版本约束，且必须带 dev- 前缀——漏掉这个前缀，90% 的报错都源于此。
为什么 composer require vendor/package:main 会失败？
Composer 默认只接受稳定版本（stable），而 main、develop 这类名称不是标签，也不是语义化版本号，它会被当作非法版本字符串拒绝。错误信息通常是：Could not find package vendor/package 或 Invalid version string "main"。
- 必须写成
dev-main，不是main，也不是dev/main - 如果项目
composer.json中设置了"minimum-stability": "stable"（默认值），还需额外加@dev后缀或运行时加--stability=dev - 私有仓库或未公开分支，需先在
repositories中声明 VCS 地址，否则 Composer 根本看不到该分支
composer require 切换分支的正确写法
这是最常用、最直接的分支切换方式，适用于已安装包的版本覆盖。
- 切换到
main分支：composer require vendor/package:dev-main - 切换到带 commit hash 的特定提交：
composer require vendor/package:dev-main#abc1234（注意是#，不是@） - 如果提示稳定性问题，补上
--stability=dev：composer require vendor/package:dev-main --stability=dev - 执行后会自动更新
composer.lock，并重装该包及其兼容依赖
用 create-project 初始化时拉取指定分支
适合新项目起步，或想完全基于某分支重建环境。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 基础写法：
composer create-project vendor/project my-app "dev-main" - 若目标分支未启用 dev 稳定性，必须加
--stability=dev参数，否则报错 - 静默安装可加
-n，删掉 .git 可加--remove-vcs，组合起来就是：composer create-project vendor/project my-app "dev-main" --stability=dev -n --remove-vcs - 别用
composer create-project vendor/project:dev-main my-app—— 冒号位置错了，会解析失败
分支更新后如何保持最新？
用 dev-branch-name 安装后，composer update vendor/package 默认仍会拉取该分支的最新提交，但有两个关键前提：
- 没有锁定 commit hash（即没写
dev-main#abc1234），否则只会固定在那个提交 - 远程分支有新推送，且你的本地
composer.lock没被手动修改过 - 如果发现没更新，先确认是否被
"prefer-stable": true干扰，可临时设为false再试
真正容易被忽略的是：分支名大小写敏感，dev-Main 和 dev-main 在多数 Git 服务器上是不同分支；另外，部分项目已弃用 master，改用 main 或 trunk，查之前先看仓库的 default branch 设置。
