先用 composer show -a 查真实版本，确认拼写、大小写及分支名；检查 minimum-stability 是否设为 dev；切换官方源验证镜像延迟；私有包需在 repositories 明确定义 vcs 源。
composer install 报 “Could not find a matching version” 怎么办
这不是包丢了，也不是网络断了，大概率是你写的版本约束根本没在源里发布过——比如写了 "guzzlehttp/guzzle": "^8.0"，但该包最新 stable 版还是 7.8.1；或者写了 "myorg/mylib": "dev-main"，但远程仓库实际分支叫 main，没打 dev- 前缀。
- 先用
composer show -a vendor/package查真实可用的版本列表（注意每行末尾的stable/dev标记） - 确认包名拼写、大小写、vendor 名是否完全一致（
spatie/laravel-backup≠spatie/backup） - 别信
composer.json里随便写的约束，直接去 https://www.php.cn/link/f69b857233949c6a79158d4bb7ab5061 看官方发布记录 - 如果目标是 dev 分支，必须写成
"vendor/package": "dev-main"，不能只写"main"或"dev-master"
装 dev 分支失败？检查 minimum-stability 和大小写匹配
Composer 默认屏蔽所有非 stable 版本。即使你写了 "dev-main"，如果顶层没声明 "minimum-stability": "dev"，它照样跳过——不是报错，是“假装看不见”。
-
"minimum-stability"必须写在composer.json根对象里，不是require下面 - 分支名大小写必须和远程仓库 100% 一致：GitHub 上是
main，就不能写dev-Main或dev-master - 带斜杠的分支（如
feature/login）必须写成"dev-feature/login"，多一个/或少一个dev-都会报Could not find a matching version - 临时验证：删掉
"minimum-stability"，改用composer require vendor/package:dev-main显式指定，看是否成功
删了 composer.lock 后 run install 就报错？命令用反了
composer install 的设计前提就是锁文件存在。你手动删了 composer.lock，再跑 install，它只会报 Lock file does not exist. Run composer update to create it.——这不是 bug，是机制。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 想按新
composer.json重算依赖：先删composer.lock，再跑composer update - 只想重装当前锁文件里的版本（比如 vendor 目录损坏）：别动
composer.lock，只删vendor/，再composer install - 只更新某一个包且不碰子依赖：
composer update vendor/package --no-update-with-dependencies -
--ignore-platform-reqs对这个错误完全无效——它只跳过 PHP 版本或扩展检查，不干预版本解析逻辑
国内镜像找不到新分支？别清缓存，先换源或等同步
阿里云、腾讯云等镜像对 dev- 分支同步有 10–30 分钟延迟，新 push 的 main 或刚打的 v3.0.0-beta1 tag 很可能还没拉过来。清本地缓存 composer clear-cache 没用，因为问题不在你本地，而在镜像没更新。
- 快速验证：执行
composer config -g repo.packagist composer https://packagist.org切回官方源，再试composer require - 查镜像状态：访问
https://mirrors.aliyun.com/composer/p2/vendor/package.json，如果返回 404 或"versions":{}，说明确实没同步 - 私有 Git 包？镜像压根不处理——必须在
composer.json的repositories里明确定义"type": "vcs"源，否则 Composer 默认只查 packagist.org - 别在
repositories里写错字段名（比如把url写成uri），Composer 会静默忽略整条配置
最常被忽略的一点：错误信息里说“找不到匹配版本”，但真正卡住的往往不是版本号本身，而是稳定性标记、分支前缀、镜像延迟这三者叠加——单独看每个点都简单，合起来就容易反复试错。动手前，先 composer show -a 和切官方源，比改十次 composer.json 更省时间。
