“Could not find package”错误主因是Composer未在预期源中找到包，需依次检查包名拼写、Packagist存在性、镜像配置有效性、私有源格式合规性、稳定性设置及PHP平台约束。
“Could not find package”不是网络卡，是 Composer 根本没在你期望的地方找到那个包——它可能拼错了、没发布、版本不可见，或者你配的源压根没生效。
检查包名和版本是否真实存在
Composer 不会猜你要装什么。报错前先确认包是不是真存在、能不能被它看见：
- 手动打开
https://packagist.org/packages/vendor/name（把vendor/name换成你实际写的），看页面是否 200；404 就说明 Packagist 上根本没有这个包 - 运行
composer search vendor/name，如果没结果，基本可判定未收录；注意大小写——spatie/laravel-backup对，spatie/backup错 - 复制粘贴包名时容易带入零宽字符或全角空格，建议手动重打一遍
vendor/name - 新发布的包（尤其是
dev-main或刚打 tag 的）可能还没同步到镜像，也未必已提交到 Packagist；GitHub 有代码 ≠ Composer 能装
确认镜像源是否生效且未过期
国内用户常以为“配过阿里云镜像就万事大吉”，但实际配置可能完全没生效，或镜像本身已停用：
- 执行
composer config -g repos.packagist（注意是repos，不是repo），输出必须是https://mirrors.aliyun.com/composer/；为空、报错或显示https://packagist.phpcomposer.com（2023 年底已停用）都算失效 - 检查
~/.composer/config.json中repositories字段是否正确写入；常见错误是拼成repo.packagist（少个s） - 项目级
composer.json若含repositories段，它会覆盖全局配置；此时要么删掉该段，要么用composer config repo.packagist composer https://mirrors.aliyun.com/composer/改项目级 - 镜像同步有延迟：打开
https://mirrors.aliyun.com/composer/看底部「最后同步时间」，超 2 小时未更新，新包大概率查不到
排查私有源或 VCS 配置是否被忽略
私有包不会出现在 Packagist，Composer 默认根本不往你公司 GitLab 或本地路径里找；配错一个字段，它就静默跳过，继续查官方源，结果当然是 “not found”：
-
repositories必须是数组，且{"packagist.org": false}必须作为**独立对象放在末尾**，例如：
"repositories": [
{"type": "vcs", "url": "https://gitlab.example.com/myorg/utils.git"},
{"packagist.org": false}
]
"packagist": false 或嵌套在其他仓库对象里，会被完全忽略"vcs"，不是 "git" 或 "github"；URL 必须是合法 git 地址，结尾只能是 .git，不能带 #main 或路径composer.json，且其中 "name" 字段与 require 中写的**完全一致**（包括大小写）auth.json 得存在且权限正确；URL 里不能含 @username，否则 Composer 会跳过认证流程别让 stability 和 platform 配置悄悄拦住包
即使包存在、源也对，Composer 还可能因稳定性约束或环境不匹配直接跳过它：
- 默认
"minimum-stability": "stable"，会过滤掉所有dev-、beta、alpha版本；若包只有dev-main，得加--stability=dev才能装 -
composer.json里若硬编码了"config": {"platform": {"php": "8.2.10"}}，而你本地是 PHP 8.1，Composer 就会假装在 8.2.10 下解析——结果就是很多包“找不到”，因为它们声明只支持 ≥8.2 - 运行
composer check-platform-reqs，它会直接列出所有缺失扩展和版本偏差，比靠报错猜快得多 - 别乱加
--ignore-platform-reqs：它能让 install 成功，但装出来的包大概率运行时报错；生产环境绝对禁用
最常被忽略的一点：报错说“找不到”，其实根本不是下载失败，而是 Composer 压根没去你配的源里查——它可能还在用已停用的旧镜像，或者 packagist.org 没关，导致私有源配置形同虚设。验证源是否生效，永远比反复清缓存更快。
