首先检查包名称是否正确，确认拼写和命名空间无误；其次验证包是否存在或已被弃用，可通过 Packagist 官网搜索；若使用镜像源，尝试切换至官方源或可靠国内镜像；最后排查网络问题，可更换网络环境或使用 -vvv 参数查看详细错误。

当你在使用 Composer 安装 PHP 包时遇到“package not found”错误，说明 Composer 无法找到你指定的包。这个问题通常由几个常见原因引起，下面列出排查和解决方法。

检查包名称是否正确

最常见的原因是拼写错误或包名不完整。

✔ 确保你在 composer require 命令中输入的包名称完全正确，包括命名空间（如 vendor/name）。 ✔ 可以访问 Packagist 官网 搜索你要安装的包，确认其准确名称。 ✔ 例如：如果你想找 Laravel 的辅助函数，应使用 laravel/helpers 而不是 helpers 或 laravel-helper。

确认包是否存在或已被弃用

有些包可能已经被删除、重命名或标记为废弃。

✔ 在 Packagist 上搜索该包，查看是否仍可访问。 ✔ 如果包已废弃（abandoned），页面会提示推荐替代包，建议改用推荐包。 ✔ 若是私有包，请确认是否配置了正确的仓库地址。

检查 Composer 镜像或仓库配置

如果你使用了国内镜像或自定义仓库，可能会导致部分包无法获取。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

✔ 运行 composer config --list 查看当前仓库配置。 ✔ 如果使用了非官方镜像（如阿里云、Laravel China 镜像），尝试切换回官方源：

composer config --unset repos.packagist
composer clear-cache
composer install

✔ 或者使用国内兼容性更好的镜像，如：

composer config repo.packagist composer https://mirrors.aliyun.com/composer/

网络或 DNS 问题

有时网络不稳定或 DNS 被污染会导致请求失败。

✔ 尝试更换网络环境，或使用代理（如公司内网限制）。 ✔ 在命令后添加 -vvv 参数查看详细错误信息：

composer require your/package -vvv

✔ 根据输出内容判断是连接超时、SSL 错误还是 404 找不到资源。 基本上就这些。多数“package not found”问题通过核对名称、切换源或检查网络即可解决。