composer show -a 看不到目标版本，说明该版本未发布、未同步至当前源或配置有误；需验证包名大小写、URL格式、repositories配置、镜像延迟及稳定性设置。
composer show -a 看不到目标版本？先确认它真实存在
报 Could not find a matching version of package vendor/name，不是 Composer 失灵，而是它查遍所有源都没找到你写的那个版本号。最直接的验证方式是运行 composer show -a vendor/name —— 如果输出为空或没列出你要的 ^2.0 对应的 2.10.0、2.9.3 等 stable tag，说明这个版本根本没发布，或没同步进当前源。
常见漏点：
- 包名大小写错：
monolog/monolog是对的，Monolog/monolog或monolog/monolong就 404 - 复制粘贴带不可见空格或全角字符，建议在纯文本编辑器里重打一遍再粘贴
- 访问 https://www.php.cn/link/94953b1a99c64501ceb078724697224f，点开 Versions 标签页，看最新 stable 版是否真能被你的约束命中（比如你写
^3.0，但页面只显示2.10.4） - 刚 push 的 tag 或新分支（如
dev-main）可能还没同步到国内镜像，延迟通常 5–60 分钟
dev-main 装不上？不是版本写错，是稳定性卡住了
dev-main 不是版本号，是分支标识符；Composer 默认只从 @stable 池里拉包，dev-main 连池子边都摸不到。即使 composer show -a 能看到它，composer require vendor/name:dev-main 仍会失败。
必须显式放行：
- 临时加
@dev后缀：composer require vendor/name:dev-main@dev - 用
--stability=dev参数：composer require vendor/name:dev-main --stability=dev - 全局改
"minimum-stability": "dev"风险高，会波及其他所有依赖，生产环境不建议 -
branch-alias在 Composer 2.0+ 已被彻底移除，写在extra里不会生效，别再试了
私有包或 Git 仓库报“找不到”？repositories 没配对或类型写错
Composer 默认只查 packagist.org，不会自动去 GitHub、GitLab 或内网 Git 服务器翻代码。你写了 myorg/mylib，但它既不在 Packagist 上，又没在 composer.json 里声明来源，那它就等于不存在。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
正确配置要点：
- VCS 类型必须显式声明为
"type": "vcs"，只写"url"会被忽略 - URL 必须指向 Git 仓库根目录（如
https://github.com/myorg/mylib），且该仓库根目录下要有合法的composer.json - 私有仓库需确保你有读取权限（SSH key 或 HTTPS token 已配置）
- 如果用的是 Satis 或 Private Packagist，
type应为composer，且 URL 指向其packages.json地址
镜像同步延迟或 provider 缓存过期？别只清 cache
composer clear-cache 清的是下载包缓存，对“找不到新包”基本无效——真正卡住的是 provider 缓存（即镜像的包索引结构文件 provider-*.json）。这些文件过期后，Composer 就“看不见”刚发布的包。
实操步骤：
- Composer ≥ 2.5：直接运行
composer update --refresh，它会精准刷新 provider 相关 JSON - 老版本：手动删缓存目录，路径按镜像 URL 转义，例如
rm -rf ~/.composer/cache/repo/https---mirrors-aliyun-com-composer - 用
curl -I https://mirrors.aliyun.com/composer/p2/vendor/name.json测镜像 API 是否返回200和较新的Last-Modified时间 - 临时切回官方源验证：
composer config repo.packagist composer https://packagist.org，再试composer install
真正卡住的地方往往不是版本号写法，而是你写的那个“版本”在当前源里压根没被索引到——要么它刚发布还没同步，要么它只存在于某个你没声明的私有源里，要么它的分支名或 tag 格式不符合 Composer 的识别规则。动手前，先用 composer show -a 和 curl 确认真实状态，比盲目调约束更省时间。
