根本原因是Composer只搜索packagist.org注册的公开包；私有仓库、Git地址、本地路径包需显式配置repositories或指定版本约束，且包名大小写、PHP版本兼容性、autoload声明等均需匹配。
composer require 报错 Could not find package
根本原因不是网络或镜像问题，而是 Composer 默认只搜 packagist.org 上已注册的公开包。如果你要装的是私有仓库、Git 仓库、本地路径包，或者包名拼写/大小写有误，composer require 就会直接报这个错。
实操建议：
- 先用
composer search确认包名是否准确——注意大小写和 vendor 名（比如monolog/monolog不等于monolog） - 如果是 Git 仓库，必须显式指定版本约束，例如：
composer require "username/repo:dev-main"（不能只写username/repo） - 私有包需提前在
composer.json的repositories字段声明源，且类型要匹配（vcs、package或path） - 检查当前项目 PHP 版本是否满足包的
require.php约束——不满足时 Composer 会“假装没看见”该包
packagist.org 搜不到但 GitHub 上明明有这个包
GitHub 仓库不会自动出现在 Packagist，必须由作者手动提交并绑定。哪怕仓库是 public 的，只要没在 Packagist 注册，composer search 就查不到。
实操建议：
- 打开
https://packagist.org/packages/{vendor}/{package}直接访问，看是否 404——这是最准的验证方式 - 如果确认没注册，只能手动添加到
repositories：例如用vcs类型指向 GitHub URL，再require时带上分支名 - 注意 GitHub 仓库的
composer.json必须存在且格式合法，否则即使加了repositories，composer install仍会失败
用了国内镜像还是搜不到包
国内镜像（如阿里云、腾讯云）只是同步 packagist.org 的公开数据，不加速私有源或未收录包。换镜像解决不了“根本不存在”的问题。
实操建议：
- 临时切回官方源验证：
composer config -g repo.packagist composer https://packagist.org - 镜像同步有延迟（通常几小时），新注册包可能还没同步过去——别急着换源，先等半天再试
- 某些镜像会过滤掉低活跃度或疑似恶意包，可查对应镜像的过滤规则说明页
require 成功但 autoload 失败：类找不到
包安装成功不代表能用——常见于包没正确声明 autoload 规则，或 PSR-4 映射路径与实际目录结构不一致。
实操建议：
- 运行
composer dump-autoload -o强制重建自动加载映射 - 检查包的
composer.json中autoload字段，特别是psr-4的命名空间前缀是否和 src 目录下文件实际路径匹配 - 如果包没声明 autoload（比如纯脚本工具），它只会被下载到
vendor/，但不会进自动加载，得手动require具体文件
repositories 配置，都会让整个流程静默失败。 
