Composer update 拉不到新 tag 是因为 Packagist 未同步：需配置 GitHub Webhook 或手动更新，且 tag 格式、Secret、URL、权限均需正确，否则同步失败。

Composer update 为什么拉不到 GitHub 上刚 push 的新 tag

因为 Packagist 不会自动扫描你的 GitHub 仓库——它只在你手动触发同步、或配置了 Webhook 后才去抓取新版本。你 git push 了 tag，composer update 却没反应，不是命令错了，是 Packagist 根本还不知道那版存在。

实操建议：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• 确认该包已在 Packagist.org 注册，且你有维护者权限
• 检查 GitHub 仓库 Settings → Webhooks 页面，是否已添加 Packagist 的 webhook（https://www.php.cn/link/5d2e892c81e5fafc51ab0973879563a0api/github），事件勾选 Releases 和 Pushes
• 如果没配 Webhook，临时补救：进 Packagist 页面点 “Update” 按钮（需登录），它会立刻拉取最新 tags
• 确保 tag 名符合 Composer 版本规范，比如 v1.2.3 或 1.2.3，别用 release-1.2.3 这种不被识别的格式

Webhook 配置后仍然不同步？查这三处

常见错误不是 webhook 没加，而是加得“半残”——比如 URL 写错、Secret 没填、或者 GitHub 仓库权限不对。

实操建议：

• Webhook URL 必须是 https://www.php.cn/link/5d2e892c81e5fafc51ab0973879563a0api/github，不能带 trailing slash，也不能写成 http
• Packagist 要求你填一个 Secret（在 Packagist 包编辑页底部生成），GitHub webhook 设置里必须填一模一样的值，否则请求会被拒
• 如果你用的是私有 GitHub 组织，确认 Packagist 已通过 OAuth 授权访问该组织——进 Packagist 头像 → “Account Settings” → “GitHub Integration”，点 “Reconnect” 重授予权限
• 触发后看 GitHub webhook 的 delivery 日志，状态码 200 且 response body 是 {"status":"success"} 才算真成功

composer update -vvv 显示 “nothing to install or update” 却明明有新 tag

这不是网络或缓存问题，大概率是 composer.json 里版本约束太死，或者 Packagist 同步延迟还没完成。

实操建议：

• 运行 composer show vendor/package 看当前解析出的可用版本列表，如果新 tag 不在其中，说明 Packagist 没同步到，别急着删 vendor
• 检查 composer.json 中依赖写法：用 "^1.2" 能匹配 v1.2.3，但写成 "1.2.0" 就只会锁死那个精确版本
• 本地调试时可加 --no-cache 参数绕过 Composer 的元数据缓存：composer update vendor/package --no-cache -vvv
• 注意 Packagist 同步有秒级延迟，tag 推送后等 10–20 秒再试，别一推就跑命令

想跳过 Packagist 直接从 GitHub 安装开发版？可以但要小心

能绕开，但代价是失去版本稳定性、破坏 lock 文件语义，且团队协作时容易踩坑。

实操建议：

• 临时测试可用 "dev-main as 1.2.3" 这种 alias 写法，让 Composer 把分支当版本用，但别提交到主分支的 composer.json
• 更稳妥的做法是加 repositories 块，指向 GitHub：

  "repositories": [
    {
      "type": "vcs",
      "url": "https://github.com/vendor/package.git"
    }
  ]

  然后 require 用 "dev-main"，但上线前务必切回 Packagist 正式源
• 所有直接引用 dev- 分支的行为，都会导致 composer.lock 记录 commit hash 而非版本号，下次 install 时无法保证复现

Packagist 同步不是“设好就完事”的黑盒，它的响应依赖 GitHub 请求、自身队列、以及你填对每一个字段——尤其 Secret 和 URL 少一个字符，整个链路就静默失败。