Composer 找不到指定 tag 是因远程仓库未推送该 tag 且 Packagist 未收录——需确认 Git tag 已执行 git push origin v1.2.3、Packagist 页面显示该版本、GitHub Release 非 draft 状态,并检查 webhook 或手动更新。

Composer 找不到指定 tag 是因为远程仓库根本没这个 tag
不是本地缓存问题,也不是 Composer 配置错了——composer require vendor/name:1.2.3 报错 Could not find package vendor/name at version 1.2.3,大概率是 Packagist 上压根没收录这个 tag。Packagist 不会自动同步所有 Git tag,必须显式触发或满足自动抓取条件(比如 GitHub webhook 正常、仓库已提交到 Packagist、tag 符合语义化格式且非预发布等)。
确认方式很简单:
打开 https://packagist.org/packages/vendor/name,看 “Versions” 标签页里有没有你想要的 1.2.3;或者直接访问 GitHub/GitLab 仓库的 Releases 页面,确认 tag 是否存在且已发布(draft 状态不算)。
重新打 tag 前先检查 Git tag 是否已推送
很多人以为本地 git tag v1.2.3 就够了,其实只是创建了本地 tag。Packagist 只读远程仓库,所以必须:
-
git push origin v1.2.3(推送单个 tag) - 或
git push origin --tags(推送所有未推过的 tag) - 检查是否成功:
git ls-remote --tags origin | grep v1.2.3
如果输出为空,说明 tag 没推上去,Composer 当然找不到。
Packagist 没自动更新?手动刷新或检查 webhook
即使 tag 已推送,Packagist 也可能延迟(几分钟到几小时),尤其在低频更新的私有包或新注册包上。这时可以:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 登录
packagist.org→ 进入你的包页面 → 点击右上角Update按钮(需有维护者权限) - 检查 GitHub 仓库的 Settings → Webhooks,确认 Packagist 的 webhook 存在且状态为
active,最近一次 delivery 是200 OK - 如果用的是自建 Satis 或 Private Packagist,要手动运行
php bin/satis build ...或触发同步任务
注意:GitHub 上标记为 Pre-release 的 tag 默认不会被 Packagist 抓取,得取消勾选再重新发布。
别用 dev- 分支名冒充稳定版
常见误操作:"vendor/name": "dev-main" 或 "dev-master" 在 composer.json 里写久了,误以为这就是稳定版。但 dev- 前缀明确表示这是开发分支,Composer 默认不启用 minimum-stability: dev,而且它和 tag 完全是两套机制。
真正想用某个 commit 当“临时稳定版”,应该:
- 基于该 commit 打一个正式 tag(如
v1.2.3-hotfix),推送并同步到 Packagist - 避免用
dev-branch#commit-hash方式,它不可靠、不兼容依赖约束、且无法被其他包正确 require - 如果只是本地调试,可用
pathrepository 类型临时指向本地目录,而不是强行打 tag
Tag 是版本锚点,不是命名空间占位符。打错一次,下游依赖就可能锁死在一个不存在的引用上。










