应直接运行composer require vendor/package:1.2.3（不带v前缀），若为私有仓库需先在composer.json的repositories中声明vcs源；写v1.2.3会被误解析为分支名导致报错。
composer require 时如何指定 Git 仓库的 tag
Composer 默认安装 dev-main 或 dev-master 分支的最新提交，但很多开源包只在打 v1.2.3 这类语义化标签后才发布稳定版。想装特定 tag，不能靠改 composer.json 后手动 run install，而是直接用 require 命令加版本约束。
关键在于：tag 名必须写成 ^1.2.3、1.2.3 或 dev-main#v1.2.3 这类 Composer 能识别的版本写法，而不是裸写 v1.2.3 —— 否则会报 Could not find package xxx at version v1.2.3。
- 如果包已注册在 Packagist，且该 tag 已被收录，直接运行：
composer require vendor/package:1.2.3
- 如果包是私有 Git 仓库（如 GitHub/GitLab），需先在
composer.json中声明仓库类型："repositories": [{"type": "vcs", "url": "https://github.com/vendor/package"}]，再执行require - 强制指定某 tag 的 commit（绕过版本解析）：用
dev-main#abc123格式，其中abc123是 tag 对应的提交哈希前7位
为什么写 v1.2.3 会失败，而 1.2.3 可以
Composer 内部把版本字符串交给 Composer\Semver\VersionParser 解析，它默认忽略 v 前缀，但仅限于语义化版本（即符合 X.Y.Z 结构）。一旦你写 v1.2.3，解析器认为这是非法版本号，转而尝试匹配分支名，结果找不到 v1.2.3 这个分支，就报错。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 合法写法：
1.2.3、^1.2、~1.2.0、dev-main#v1.2.3 - 非法写法：
v1.2.3、V1.2.3、release/v1.2.3（除非你把它定义为分支） - 查看包支持哪些版本：运行
composer show vendor/package --all，输出里带tag标记的行才是真实可用的 tag
使用 --prefer-dist 和 --prefer-source 对 tag 安装的影响
加 --prefer-dist（默认）会让 Composer 尝试从 Packagist 下载 zip 包；加 --prefer-source 则强制走 git clone。这对 tag 安装很关键：某些私有仓库没配置 dist 镜像，或 zip 包未生成，此时不加 --prefer-source 就会卡在 “Downloading failed”。
- 私有 GitLab 项目打 tag 后，首次安装建议加
--prefer-source，避免因 dist URL 未就绪导致失败 - CI 环境中若禁用了 git，又依赖私有 tag，则必须确保对应 tag 的 zip 已上传到 dist endpoint，否则只能失败退出
-
composer config --global prefer-stable true不影响 tag 选择逻辑，它只控制是否允许安装dev-前缀的不稳定版本
遇到 “no matching package found” 时怎么快速定位
这个错误常让人误以为是网络或权限问题，其实多数情况是版本字符串写错，或目标 tag 根本没被 Composer 索引到。
- 先确认 tag 是否真实存在：去 GitHub 页面打开
Releases或Tagstab，看v1.2.3是否绿色显示（说明已 push） - 检查是否漏了
repositories配置：私有包必须显式声明，且url必须是可 git clone 的地址（https://或git@） - 清除本地缓存再试：
composer clear-cache，因为旧缓存可能记录了“该包无此版本”的错误判断 - 开启调试模式看细节：
composer require vendor/package:1.2.3 -vvv，重点关注 “Reading composer.json of …” 和 “Skipped tag v1.2.3” 类提示
repositories 这一硬性前提。
