Composer通过规则匹配判断输入是tag还是branch：含dev-前缀或匹配远程同名分支则按分支处理，否则匹配tag；v2.9.1明确识别为tag，2.9.1若存在同名分支则误判为分支；验证用composer show --all查看是否列出带v前缀且无(branch)标记的版本。
Composer怎么判断你写的到底是tag还是branch
它不靠猜，靠规则匹配。输入字符串一旦被识别为分支名（含dev-前缀、或匹配远程已存在的同名分支），就走分支逻辑；否则才尝试匹配tag。
常见误判场景：
- 写
composer require monolog/monolog:2.9.1，但远程仓库同时存在分支2.9.1和tagv2.9.1→ Composer 会拉分支，不是tag - 写
composer require monolog/monolog:main，而远程只有main分支、无maintag → 拉分支，且可能报错“no matching package”，因为main不是稳定版本 - 写
composer require monolog/monolog:v2.9.1→ 明确带v前缀，优先匹配tag，几乎不会误判
验证方法：运行composer show monolog/monolog --all，看输出里v2.9.1是否在versions列表中，并确认旁边没标(branch)字样。
require里写tag为什么没锁死版本
因为composer require默认把tag转成caret约束，比如v2.9.1变成"^2.9.1"，下次composer update仍可能升到2.9.2或2.10.0（只要符合语义化规则）。
真正锁死的写法只有两种：
-
"monolog/monolog": "=2.9.1"（Composer 2.2+ 支持，严格等号匹配） -
"monolog/monolog": "2.9.1"（无任何前缀，手动改完后必须跑composer update monolog/monolog生效）
别信composer.lock里显示version: 2.9.1就以为锁死了——关键看reference字段是不是对应tag的commit hash。如果是dev-main那种hash，说明实际装的是分支快照。
dev-分支和tag混用时的缓存陷阱
dev-分支默认不刷新远端最新commit，哪怕你删了vendor重装，也可能复用旧的dist包或缓存的hash。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
强制拉最新提交的实操方式：
- 加
--no-cache：composer require vendor/pkg:dev-main#main --no-cache - 先清缓存：
composer clear-cache，再require或update - 更可控：直接在
composer.json里写"vendor/pkg": "dev-main#main"，然后composer update vendor/pkg
注意：#main后缀不是可选的——它告诉Composer“以main这个分支名为基准拉HEAD”，没它可能 fallback 到dev-main的旧hash。
私有仓库或fork分支必须显式声明repositories
Packagist不认识你的GitLab私有库，也不认你fork的GitHub仓库，不声明源就等于包不存在。
最小可用配置示例：
{
"repositories": [
{
"type": "vcs",
"url": "https://gitlab.example.com/acme/utils.git"
}
],
"require": {
"acme/utils": "dev-feature/auth"
}
}
要点：
-
url必须是完整Git地址，不能是网页URL -
type固定为vcs，不是package或composer -
require里的包名仍用原始命名（如acme/utils），不是yourname/utils - SSH私有库需提前配好key，否则
composer install会卡在认证
分支名大小写敏感，dev-Feature/Auth ≠ dev-feature/auth；含斜杠必须保留dev-前缀，不能简写为feature/auth。
