Composer报“Package not found”主因有四：包名拼写或大小写错误；私有包SSH/HTTPS凭据未生效；repositories配置语法错误（如type非"vcs"、url非法、缺{"packagist.org": false}）；国内镜像同步延迟或过滤。
包名拼错或大小写不一致导致“not found”
Composer 对 vendor/name 的大小写和拼写是严格校验的，错一个字母、多一个空格、大小写颠倒（比如 spatie/laravel-backup 写成 spatie/Laravel-Backup）都会直接报 Package not found，而不是提示“接近的包”。
- 用
composer search验证：运行composer search spatie backup，看返回结果里是否含完整、准确的spatie/laravel-backup - 打开
https://packagist.org/packages/spatie/laravel-backup确认页面可访问且未标为 abandoned - 私有包必须与
composer.json中name字段**逐字一致**——包括 vendor 名、分隔符、连字符，不能靠“差不多”推测
私有仓库 404 的真实原因不是网络，是 SSH 或 HTTPS 凭据没生效
Composer 拉私有 Git 包时，第一步不是下载，而是执行 git clone。如果这步失败，它不会报 “SSH failed”，而是静默 fallback 到 Packagist，最终报 Package not found。
- 先手动验证连接：
ssh -T git@your-git-host—— 必须返回 welcome 信息；若卡住或报Permission denied (publickey)，Composer 必然失败 -
ssh-add -l看密钥是否已加载；为空则运行ssh-add ~/.ssh/id_ed25519（路径按你实际密钥调整） - HTTPS 方式下，
git clone https://gitlab.example.com/org/pkg.git若卡在could not read Username，说明凭据管理器没启用：执行git config --global credential.helper store，再手动跑一次git clone输入账号密码完成缓存
repositories 配置被忽略？检查 type、url 和 packagist.org 开关
Composer 对 repositories 数组的语法极其敏感，错一个字段就静默跳过整条配置，继续查官方源。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
type必须是"vcs"（不是"git"、"github"，也不能省略） -
url必须是合法git clone地址：git@gitlab.company:group/repo.git或https://gitlab.example.com/org/pkg.git；结尾带#main或网页路径（如/-/tree/main）会失败 -
{"packagist.org": false}必须作为独立对象放在repositories数组**末尾**，不能嵌套、不能写成"packagist": false；否则 Composer 仍会优先查官方源兜底
镜像源延迟或过滤导致新包“不可见”
国内镜像（阿里云、腾讯云等）同步 Packagist 有 5–30 分钟延迟，新发布的包或刚打的 tag 可能还没入库；部分镜像还会主动过滤 license 不合规、含敏感词或扫描失败的包。
- 别只信
composer clear-cache—— 它不清元数据缓存；真正要删的是~/.composer/cache/repo/https---mirrors-aliyun-com-composer这类子目录 - 临时切回官方源验证：
composer config --global repo.packagist composer https://packagist.org，再composer require vendor/name -vvv看日志是否开始Downloading https://packagist.org/... - 浏览器直访镜像地址验证：
https://mirrors.aliyun.com/composer/p/vendor/name.json，404 就说明镜像还没同步，不是你本地问题
最常被忽略的是：私有仓库配置后不检查 ssh -T 是否通，以及 repositories 里漏掉 {"packagist.org": false} —— 这两个点同时存在时，错误表现和网络问题一模一样，但根源完全不在网络层。
