答案是先验证包是否存在：访问https://packagist.org/packages/vendor/name确认页面可打开，再用composer search vendor/name和检查包名大小写、不可见字符；若存在则排查镜像失效、同步延迟、缓存残留或repositories配置错误。
Composer 报 “Could not find package” 不是网络问题，大概率是包根本没被它“看见”——要么拼错了，要么没告诉它去哪找。
包名拼错或大小写不匹配
Composer 对 vendor/name 是严格区分大小写的，spatie/laravel-backup 写成 spatie/Laravel-Backup 或 spatie/backup 都会 404。
- 先用
composer search laravel-backup确认包是否存在（注意：它查的是 Packagist 全量索引，不代表能装） - 打开 https://www.php.cn/link/03f1c2a49f73ee5237758fbf01923d12 看是否 200，URL 路径是否完全一致
- 私有包更要注意：
myorg/my-tool的name字段必须和require里一模一样，不能多空格、下划线或连字符
私有包或本地 path 包没配 repositories
Composer 默认只查 Packagist，你把包放在 ../my-package 或公司 GitLab 上，它不会自动扫描——必须显式声明源。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- path 类型：确保
repositories块中type是"path"，url是相对路径（如"../my-package"），且目标目录下有含正确name的composer.json - vcs 类型（Git）：
type必须是"vcs"，url要带.git后缀（尤其 GitLab 自建实例），且仓库根目录有有效composer.json - 配置后务必运行
composer clear-cache，否则旧缓存会让新配置静默失效
镜像源不同步或已停用
国内镜像不是 Packagist 的实时镜像，新发布的包、dev 分支、或已被下架的包，很可能在镜像里查不到。
- 检查当前源：
composer config --list | grep repo.packagist，确认输出是完整 JSON 且 URL 以/结尾（少斜杠会拼错路径导致 404） - Laravel China 镜像已于 2023 年底停用，若还配置着，必报 404；推荐阿里云：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 临时切回官方源验证：
composer config -g repo.packagist composer https://repo.packagist.org，再试composer show vendor/name
稳定性约束拦住了 dev/beta 版本
默认 minimum-stability 是 "stable"，哪怕包存在 dev-main，也会被直接过滤掉。
- 运行
composer show vendor/name，如果返回空，但composer search能搜到，基本就是稳定性问题 - 临时装一个 dev 版：
composer require vendor/name --stability=dev --prefer-source - 不建议长期改
minimum-stability到dev，容易引发其他包升级失控；更稳妥的是在require时单独指定分支别名，如"dev-main as 1.0.x-dev"
最易被忽略的一点：自定义 repositories 配置错一个字段（比如 type 写成 "package" 而非 "path"），Composer 就会静默跳过该源，继续查 Packagist——错误信息还是 “not found”，但原因根本不在包本身。
