Packagist不显示新版本是因为未同步：需手动点击“Update”或配置GitHub Webhook；确保tag与composer.json中version一致（推荐删除version字段）；清除本地缓存并检查composer.lock及语义化版本约束。
更新后的包为什么Packagist不显示新版本？
Packagist 不会自动扫描你的仓库来发现新 tag，它只在你主动触发同步、或配置了 GitHub/GitLab Webhook 时拉取元数据。没同步 = 新版本“不存在”于 Packagist。
- 手动同步最可靠：进入 Packagist 上该包的页面，点 “Update” 按钮（需登录并有维护权限）
- 推荐长期方案：在 GitHub 仓库的
Settings → Webhooks中添加 Packagist 的 webhook（URL 是https://packagist.org/api/github），Payload format 选application/json，只勾选Tag creation - 若用私有 GitLab 或其他平台，得用
composer update命令配合packagist:push（需 CLI token）——但绝大多数人用的是 GitHub，走 webhook 就够了
composer.json 版本号写错导致同步失败
Packagist 解析版本靠的是 Git tag 和 composer.json 里 version 字段的一致性。两者不匹配，同步会静默失败或显示为 invalid version。
- Tag 必须是语义化格式，如
v2.1.0、2.1.0；2.1或main这类非标准 tag 不会被识别为稳定版本 -
composer.json中的version字段**不是必须写的**——99% 的情况应该删掉它，让 Packagist 自动从 tag 推断版本 - 如果写了
version，它必须和 tag 完全一致（包括v前缀），比如 tag 是v3.0.0，version就得是"v3.0.0"，不能是"3.0.0"
提交新版本后 composer require 还拉不到最新版
不是 Packagist 没更新，而是本地 Composer 缓存了旧的包元数据，或者项目 composer.lock 锁死了旧版本。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先运行
composer clear-cache清掉本地缓存 - 再执行
composer show vendor/package-name看 Packagist 返回的可用版本列表，确认新版本已出现 - 如果
composer.lock存在且锁定了旧版本，直接composer update vendor/package-name（不要加--lock） - 注意：如果项目
composer.json中写死依赖为"^2.0"，而新版本是3.0.0，默认不会升级——语义化版本规则下^2.0≠3.0.0
Webhook 同步失败常见错误信息
GitHub 发送 webhook 后，Packagist 返回失败响应，你在 GitHub Webhook 日志里会看到类似：
{"status":"error","message":"Invalid package definition","errors":["The 'name' field is required"]}
这类报错基本都指向 composer.json 格式问题：
-
name字段缺失或格式错误（必须是vendor/name全小写，不含空格、下划线、大写字母） -
type字段值非法（比如写成library而不是library是允许的，但写成mylib就不行；建议留空或用标准值library/metapackage） - JSON 语法错误（多逗号、单引号、中文标点）——用
composer validate本地检查最省事
真正麻烦的是“没报错但也不更新”，大概率是 tag 没推到远程：git push origin --tags 别漏掉 --tags。
