答案：composer报“package not found”主因是源中确实不存在该包，非网络或权限问题，需先验证包名拼写、packagist存在性、repositories配置完整性及镜像同步状态。
composer install 报 “Package not found” 是源里真没这个包
不是网络超时，也不是权限问题，更不是 Composer 本身坏了——它只是老实告诉你：packagist.org（或你当前配置的源）里压根没有你写的那个 vendor/name。常见现象包括：Could not find package spatie/laravel-backup、Package monolog/monolg not found（注意末尾少了个 o）。
先别删 vendor 或重装 Composer，直接验证两件事：
- 运行
composer show -a spatie/laravel-backup—— 如果返回空，说明当前源确实没这个包 - 打开浏览器访问
https://packagist.org/packages/spatie/laravel-backup—— 404 就是作者没发布，或名字拼错 - 检查
composer.json里的包名：大小写敏感（monolog/monolog对，Monolog/monolog错），vendor 名不能缩写（spatie/backup≠spatie/laravel-backup）
私有包 404？repositories 配置漏字段就等于没写
私有 Git 包报 404，90% 是 repositories 区块写得不全，Composer 静默忽略，继续查默认源，结果当然找不到。
必须确保 composer.json 里包含完整类型和 URL，例如：
"repositories": [
{
"type": "vcs",
"url": "https://gitlab.example.com/mygroup/mylib.git"
}
]
常见坑点：
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
-
type字段不能缺，也不能写成"git"—— 正确值是"vcs" - URL 必须指向 .git 结尾的仓库地址，不能是网页首页
- Git 分支或 tag 必须真实存在：
"dev-main"要求远程有main分支，"1.2.3"要求有对应 tag - GitHub 私有库需 token 认证：token 必须有
read:packages权限，且 URL 里不能带@username（否则auth.json不生效）
用了阿里云镜像还 404？镜像不创造包，只缓存已发布的
国内镜像（阿里、腾讯、华为）只是同步 packagist.org，不会“上架”未发布或被过滤的包。新发布的包可能延迟几小时才同步，某些含敏感词、非标准 LICENSE 的包会被镜像主动过滤。
临时验证是否镜像问题：
- 切回官方源：
composer config -g repo.packagist composer https://packagist.org - 再跑一次
composer show -a vendor/name - 如果官方源也查不到，说明包真不存在；如果官方源能查到而镜像查不到，就是同步延迟或策略过滤
- 别指望换镜像解决私有包问题——私有源必须单独在
repositories里声明，公共镜像根本不知道它存在
加了 -w 参数反而报 not found？这是依赖冲突伪装的假错误
composer require vendor/name -w 中的 -w（--with-dependencies）会让 Composer 强制合并当前项目所有已安装包的依赖树。一旦某个已有包锁定了过老的子依赖版本，而你要装的新包要求更高版本，Composer 就会放弃安装，报 Package not found —— 实际是“无法满足依赖”，但错误信息没说清。
解决方法很简单：
- 去掉
-w重试：composer require vendor/name - 如果必须用
-w，先跑composer update --dry-run看具体哪条依赖卡住了 - 日常新增包不需要
-w；它只适合明确要升级整条依赖链的场景 - 旧版 Composer（尤其是 1.x）对
-w处理更激进，建议升级到 2.x
最容易被忽略的是：错误提示里出现 ignore-platform-reqs 时，很多人直接加参数硬上，结果装完运行时报错。这不是包的问题，而是 PHP 版本、扩展缺失或 platform 配置与实际环境不匹配——得先修环境，而不是绕过校验。
