Composer查不到新版本主因是稳定性约束过滤、元数据缓存未更新或源配置未生效；需用composer show --all --no-cache验证，确认repositories配置正确且minimum-stability匹配。
包版本不存在，90% 是 Composer 没“看见”它——不是没发布，而是被稳定性约束过滤、元数据缓存过期、或源配置未生效。
为什么 composer show --all 查不到新版本
查不到 ≠ 包没发，而是本地元数据没更新或环境不匹配：
-
composer show --all默认只拉取你当前composer.json中config.platform和minimum-stability允许的版本；比如设了"php": "8.1"，而目标版本 require"php": "^8.2"，它压根不会出现在结果里 - 镜像源已同步新版本，但 Composer 还在读本地缓存的
packages.json（尤其国内镜像常有 5–15 分钟延迟） - 私有 VCS 仓库（如 GitLab）未在
repositories中正确定义type: "vcs"，整条配置被静默忽略，Composer 根本不去访问 - 运行
composer clear-cache后仍无效？加--no-cache强制跳过缓存：composer show --all vendor/name --no-cache
composer show 显示旧版本，但远程已有新 tag
这说明 Composer 锁定了旧版本，或没触发元数据刷新：
- 先确认是否真发布了 tag：打开
https://packagist.org/packages/vendor/name或私有源 Web 页面，看最新 tag 是否可见 - 检查
composer.lock里该包的version字段，如果是"dev-main"或带 commit hash，说明装的是开发分支，不是 tag 版本 - 删掉
vendor/和composer.lock，再跑composer install—— 不要只update，否则 lock 文件可能继续 hold 住旧约束 - 若用私有 Git 仓库，确保 URL 结尾是
.git，且不含分支/commit 后缀（如https://gitlab.example.com/myorg/pkg.git✅，...pkg.git#main❌）
怎么快速验证某个版本能否装进当前项目
别靠猜，用 Composer 自带命令做最小模拟：
- 运行
composer require vendor/name:1.2.3 --dry-run，它会输出完整依赖解析过程，卡在哪一行就一目了然 - 如果报错
[InvalidArgumentException] Package not found，说明这个版本号根本没被任何已启用的源索引到——不是兼容问题，是源没生效 - 想定位谁在锁版本？用
composer depends -r vendor/name，重点看带requires的行，尤其是require-dev里的测试工具（如phpunit/phpunit常拖慢整个生态升级） - 临时放宽限制试装：加
--stability=dev或改composer.json里的minimum-stability，但装完立刻还原，避免污染其他依赖
私有包版本始终 404，但 URL 能 curl 通
能 curl 通 ≠ Composer 能读元数据，关键在第一步握手：
- VCS 类型必须写
"type": "vcs"，写成"git"、"github"或漏掉，整条repositories条目被忽略 - Git 仓库根目录必须有合法
composer.json，且其中name字段必须和你在require中写的完全一致（包括大小写） - 如果用了 GitHub/GitLab Token 认证，确保已执行
composer config -g github-oauth.github.com xxx，且 Token 有read:packages权限 - 最关键的一步：运行
composer config repositories，确认输出里确实包含你配的私有源，并且{"packagist.org": false}独立存在、位于数组末尾
最常被忽略的点：你以为在查远程，其实 Composer 正在读本地 vendor/composer/installed.json；只要 vendor/ 目录存在，composer show 就不会联网——想确认真实可用版本，必须用 --all 或 --no-cache，且确保源配置已真正生效。
