答案是先验证包是否真实存在：访问https://packagist.org/packages/vendor/name确认页面可打开，再用composer search vendor/name和检查包名大小写、不可见字符；若存在则排查镜像失效、同步延迟、缓存残留或repositories配置错误。
“Package not found”不是网络问题，而是 Composer 根本没去对的地方找——要么包真不在源里，要么它压根没读你配的源。
确认包是否真实存在于 Packagist
别跳过这步直接清缓存或换镜像。Composer 的 Could not find package 错误，90% 源头是包名本身有问题。
- 打开
https://packagist.org/packages/vendor/name（把vendor/name替换成你要装的完整包名），看是否返回 404 页面 - 运行
composer search vendor/name—— 如果没结果，说明 Packagist 官方索引里确实没这个包，不是镜像同步慢，是它根本没被收录 - 检查大小写：
spatie/laravel-backup✅，spatie/backup❌，Monolog/monolog❌ - 复制包名时小心不可见字符：从网页、微信、钉钉粘贴容易带零宽空格或全角斜杠，建议手动重打一遍
验证当前用的是哪个镜像源
很多人改了配置却还在请求 https://packagist.org/，日志里全是 404，其实是配置压根没生效。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 运行
composer config -g repos.packagist（注意是repos复数！Composer ≥ 2.2 后repo.packagist会静默忽略） - 输出应为类似
{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}；如果为空、报错或显示旧地址（如https://packagist.phpcomposer.com），说明镜像未正确配置 - 项目级
composer.json中若含"repositories"字段（哪怕只是空数组[]），会**完全屏蔽全局镜像**，此时要查composer config repos.packagist（不加-g）
检查镜像是否真同步了你要的版本
Packagist 网页显示 v3.6.0 ≠ 镜像的 p2 接口已同步。元数据不同步才是“包存在但装不上”的主因。
- 查官方源最新版：
curl -s https://packagist.org/p2/monolog/monolog.json | jq -r '.packages."monolog/monolog" | keys[]' | sort | tail -3 - 查阿里云镜像同步状态：
curl -s https://mirrors.aliyun.com/composer/p2/monolog/monolog.json | jq -r '.packages."monolog/monolog" | keys[]' | sort | tail -3 - 若镜像缺少目标版本，临时切回官方源验证：
composer config -g repos.packagist composer https://packagist.org，再执行composer clear-cache
私有包或 VCS 仓库始终 404 的关键点
VCS 类型仓库不会出现在 Packagist 索引里，composer search 永远搜不到它——能搜到只是巧合（同名空包）。require 时找不到，99% 是 repositories 配置被静默忽略。
-
"type"必须是"vcs"，写成"git"或漏掉，整条配置失效 -
"url"必须是可git clone的地址，且结尾只能是.git，不能带#main或路径后缀 - 目标仓库根目录必须有合法
composer.json，其中"name"字段必须与composer require时写的**完全一致**（包括大小写） - 若启用了
"packagist.org": false，它必须是repositories数组里的一个独立对象，且放在末尾；写成"packagist": false或嵌套在其他仓库对象里，均无效
最常被忽略的是：私有包的 repositories 配置一旦字段写错，Composer 不报错也不提示，而是直接跳过，继续查默认源——所以你看到的 404，其实是“它根本没尝试连你的 GitLab”。
