唯一可靠方式是手动编辑composer.json的require字段写"vendor/name": "dev-branch#commit-hash"并运行composer update vendor/name；需满足包源为VCS类型、commit已推送远程、name字段与require中包名完全一致。
composer require 怎么写才能装对 dev 分支
直接写 composer require vendor/name:dev-main 是最简方式，但几乎每次都会失败——不是分支名错、就是稳定性没放开、或私有库缺源声明。必须同时满足三个条件：分支名与远程 Git 完全一致（大小写、斜杠都不能错），加 --stability=dev 或用 @dev 后缀，私有仓库还得提前在 repositories 里声明 vcs 类型。
常见错误现象：Could not find package vendor/name at version dev-main。这通常意味着：远端根本没有 main 分支（可能是 develop 或 master），或者你写了 dev-Main（大小写不匹配），又或者没加 --stability=dev，Composer 根本不进解析流程。
- 分支含斜杠（如
feature/login）必须用双引号包裹：composer require "vendor/name:dev-feature/login" --stability=dev - 不要省略
dev-前缀，composer require vendor/name:feature/login会被当成版本号解析，大概率报错 - GitHub 新仓库默认分支是
main，继续用dev-master会直接失败
私有 Git 仓库怎么指定分支
Packagist 上没注册的包，Composer 不知道从哪拉，repositories 配置缺一不可。type 必须是 vcs，URL 必须带 .git 后缀，否则解析失败。
示例配置（写在项目根目录 composer.json 的顶层）：
{
"repositories": [
{
"type": "vcs",
"url": "https://gitlab.example.com/acme/utils.git"
}
]
}
之后才能执行：composer require acme/utils:dev-main --stability=dev。如果 URL 是 SSH 地址（如 git@gitlab.example.com:acme/utils.git），确保运行命令的机器已配好对应 SSH key。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 没配
repositories就执行require，必然报Could not find a version of package -
url字段漏掉.git后缀，Composer 会尝试走 HTTP 协议探测，多数情况超时或返回 404 - 多个私有源要并列写在
repositories数组里，不能嵌套
怎么让分支依赖锁定到具体 commit
默认 dev-main 是浮动的，composer update 会拉取该分支最新提交。生产环境必须锁定，否则上游 force push 会导致下次 install 失败——因为 composer.lock 里存的旧 hash 找不到了。
可靠写法是显式带上 # 和 commit hash："acme/utils": "dev-main#abc1234"。注意 hash 至少 7 位小写，不能写成 HEAD 或 main。
- 加
--prefer-source参数确保走 Git 克隆（而非 zip 包），否则#hash可能被忽略 - 验证是否真锁住：检查
composer.lock中该包的source.reference字段，值必须是 40 位或至少 7 位小写哈希 - 手动改完
composer.json后，必须运行composer update acme/utils，仅install不会更新 lock 文件
branch-alias 是什么，什么时候要用
branch-alias 是被依赖方（即你要引用的那个包）自己声明的映射规则，作用是让其他项目能用语义化版本（如 ^2.0）来依赖它的开发分支。它只在被依赖方的 composer.json 里生效，且只对 dev- 开头的分支起作用。
正确写法（放在被依赖包的 composer.json 的 extra 下）：
{
"extra": {
"branch-alias": {
"dev-main": "2.0.x-dev"
}
}
}
依赖方写 "acme/utils": "^2.0" 才会命中这个别名。如果依赖方直接写 "acme/utils": "dev-main"，别名完全不参与解析。
- 别名末尾必须带
-dev，写成"2.0.x"会被忽略 - 本地用
path类型仓库时，branch-alias不生效——这是设计限制，只用于 VCS 场景 - 别名配了但没效果？先确认目标分支已
git push到远程，且 Packagist 或私仓已完成索引
repositories 配置必须带 .git 后缀、以及 composer.lock 里 source.reference 的值必须是 commit hash 而不是分支名。 
