Composer识别版本依赖Git tag而非composer.json的version字段，必须推送tag至远程、配置Packagist Webhook并确保name匹配，否则composer require无法拉取对应版本。
Composer包打版本标签前，必须确保Git仓库干净且已推送到远程
Composer识别版本靠的是Git的tag，不是composer.json里的version字段——那个字段只在本地开发或非Git源时起作用。如果没打tag或tag没推上去，composer require会拉不到你期望的版本，甚至报Could not find package或no matching package found。
- 先检查当前分支是否已提交所有变更：
git status应该显示“nothing to commit” - 确认远程仓库地址正确：
git remote get-url origin，尤其注意是SSH还是HTTPS，影响后续packagist同步 - 打tag前务必推送代码：
git push origin main（或你的默认分支），否则tag孤立在本地 - tag命名要符合语义化版本规范，比如
v1.2.0、v2.0.0-beta.1；1.2.0（缺v前缀）可能被Packagist忽略
用git tag命令打标签并推送到GitHub/GitLab
打tag本身很简单，但推不上去就等于没打。Packagist（或私有仓库如Satis）只监听远程tag创建事件，不会轮询本地。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 打轻量标签（推荐）：
git tag v1.3.0 - 打带注释的标签（更规范，便于追溯）：
git tag -a v1.3.0 -m "release: add cache invalidation hook" - 推送单个tag：
git push origin v1.3.0 - 推送所有本地tag（慎用）：
git push origin --tags——如果之前打过测试tag（如v0.1.0-rc1）又没删，会一并暴露 - 删错的tag（本地+远程）：
git tag -d v1.3.0 && git push origin :refs/tags/v1.3.0
Packagist自动更新失败？检查Webhook和包名匹配
打完tag只是第一步，Packagist需要收到通知才能抓取新版本。很多人卡在这步，以为“打了tag就完了”，结果composer update还是拉不到最新版。
- Packagist页面上你的包必须开启“Automatically update this package”开关（在
Edit Package里） - GitHub/GitLab仓库的Webhook要指向
https://packagist.org/api/github（或对应私有仓库的API端点），且事件类型包含create（不是push） - 确保
composer.json里的name字段（如"myvendor/my-package"）和Packagist注册时填的一致，大小写敏感 - 如果用私有仓库，确认其配置支持监听
tag事件，有些Satis部署默认只扫描master分支
验证版本是否生效：别只信composer show
composer show myvendor/my-package显示的版本列表，可能缓存了旧数据。真正可靠的方式是让另一个项目去拉一次。
- 新建测试目录：
mkdir test-pkg && cd test-pkg && composer init -n - 强制拉指定版本：
composer require myvendor/my-package:v1.3.0，观察是否成功安装 - 如果报
Could not find a version of package matching your minimum-stability，检查composer.json里minimum-stability是否为stable，而你打的是beta或dev标签 - 想看Packagist实际收录了哪些版本？直接访问
https://packagist.org/packages/myvendor/my-package，页面底部有“Versions”列表，实时性比本地命令高
minimum-stability与tag命名风格不匹配——这两个问题占了80%以上的“明明打了tag却拉不到”的案例。 
