“no matching package found”说明Composer未查到包名，非版本问题；应检查包名拼写、大小写、斜杠方向是否与Packagist完全一致，确认私有源已配置、缓存已清理，并用composer show -a或Packagist网页验证版本是否存在。
composer show vendor/package 报 “no matching package found” 怎么办
这说明 Composer 根本没在当前配置的源里查到这个包，不是版本问题，是“连名字都对不上”。最常见原因是包名拼错或源没配全。
检查点列在下面：
-
vendor/package大小写、连字符、斜杠方向是否和 Packagist 页面 完全一致（比如laravel/sanctum不是laravel-sanctum） - 运行
composer config repositories看是否漏了私有源；私有 Git 包必须显式加"type": "vcs"声明，不能只写 URL - 如果包刚提交到 Packagist，可能有最多 1 分钟延迟，稍等再试
- 执行
composer clear-cache后重试，避免本地缓存了过期的索引
composer show -a vendor/package 列不出 dev-main 或分支怎么办
分支名不在 -a 输出里，大概率是远程仓库根本没这个分支，或者分支没打任何 tag、没声明 branch-alias，导致 Composer 不认为它是可安装的“版本源”。
验证方式很直接：
- 用
git ls-remote --heads https://github.com/vendor/repo main确认分支是否存在（把 URL 换成你实际的仓库地址） - 进该仓库的
composer.json，检查是否有"extra": {"branch-alias": {"dev-main": "1.0.x-dev"}}这类声明 - 没有
branch-alias的开发分支，Composer 默认不把它当“可用版本”，即使分支存在也无法通过require vendor/package:dev-main安装 - 临时解决：加
@dev后缀，如composer require vendor/package:dev-main@dev，强制允许不稳定分支
为什么 composer install 能跑通，但 composer show vendor/package 却找不到
因为 composer install 只依赖 composer.lock 里的已知哈希和路径，它不查元数据；而 composer show 必须实时拉取包的 composer.json 元信息——一旦源不可达、认证失效或包被删，就会报错。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
典型场景和对应动作：
- 私有 GitLab 仓库 token 过期 → 更新
auth.json中的token或http-basic凭据 - 包已被作者从 Packagist 移除（但 lock 文件里还留着）→
composer show必然失败，但只要 vendor 文件还在，项目仍可运行 - 网络策略拦截了
repo.packagist.org的 API 请求 → 换国内镜像源：composer config repo.packagist composer https://packagist.phpcomposer.com - 运行
composer diagnose，它会明确告诉你哪些源无法访问
vendor/ 下有包目录，但 composer show -i 不显示它
说明这个包不是通过 Composer 安装的，而是手动扔进去的、用 symlink 接入的，或者被 composer remove 后残留了文件夹。Composer 只认 vendor/composer/installed.json 里登记过的包。
确认方法很简单：
- 打开
vendor/composer/installed.json，搜索包名，看有没有对应条目 - 检查该包目录下是否存在
composer.json，且内容是否合法（比如name字段是否匹配） - 如果只是想让它被识别，别改文件结构，直接运行
composer dump-autoload——但它不会自动补进 installed.json，必须走require或install - 误删了
installed.json？别手动生成，删掉整个vendor/再composer install，这是唯一可靠重建方式
元数据缺失最麻烦的地方在于：它不报错，只“静默失效”。composer show 查不到、IDE 跳转失效、why-not 分析失真——所有依赖推理都基于元信息，缺了它，Composer 就只剩一个“文件搬运工”。
