答案是先验证包是否存在:访问https://www.php.cn/link/f69b857233949c6a79158d4bb7ab5061确认页面可打开,再用composer search vendor/package检查;若存在则排查镜像延迟、元数据缓存过期或repositories配置错误。

执行 composer update vendor/package 报“Package not found”
这不是网络问题,而是 Composer 根本没在当前源里查到这个包名——可能拼错了、包已废弃、或镜像未同步。先别删 vendor 或 composer.lock。
检查三件事:
- 运行
composer search vendor/package,确认包名是否准确(注意大小写和斜杠方向) - 访问 https://www.php.cn/link/f69b857233949c6a79158d4bb7ab5061 看是否 404 或标有
abandoned - 执行
composer config -g repo.packagist,确认输出是带尾斜杠的 HTTPS 地址(如https://packagist.org/),不是 HTTP 或无斜杠旧格式
若包确实不存在,composer update 不会帮你“猜名字”,也不会 fallback 到近似名。
composer require 提示包不存在,但 Packagist 上明明有
常见于镜像延迟或本地元数据过期。Composer 默认只缓存远程包列表 30 分钟,但国内镜像常滞后数小时。
强制刷新元数据的最小动作是:
- 运行
composer clear-cache—— 清掉~/.composer/cache/repo/下的 JSON 缓存 - 加
-vvv看真实请求:composer require vendor/package -vvv 2>&1 | grep "GET https",确认它打的是镜像地址还是 packagist.org - 临时切回官方源验证:
composer config --global repo.packagist composer https://packagist.org/,再试一次require
别用 --no-cache,它只跳过 ZIP 缓存,不影响包元数据缓存。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
想重装一个已安装但疑似损坏的包
composer update vendor/package 不会删已有目录,哪怕文件已乱;--no-cache 也不触发重解压。真要从头来,得走删除 + 重拉路径。
- 先删对应目录:
rm -rf vendor/vendor/package(Linux/macOS)或rd /s/q vendor\vendor\package(Windows) - 再执行
composer install --no-cache --force-reinstall—— 注意:这个命令只对composer.lock里已有的条目生效,不会改版本 - 如果连
composer.lock里的记录都不可信,就先git checkout -- composer.lock回退,再install
Windows 下建议关掉 PhpStorm/Xdebug,否则 rm -rf 可能失败,报错 Permission denied。
为什么 composer update "vendor/package:^1.2" 总是失败?
引号 + ^ 是最隐蔽的坑:Composer 会把它当通配符去远程搜“最新兼容版”,而不是按你写的约束解析。一旦源里没有匹配的版本(比如只有 1.0.0 和 2.0.0),就直接报“not found”。
- 正确写法是去掉引号:
composer update vendor/package:^1.2 - 更稳妥写法是写死版本:
composer require vendor/package:1.2.0 - 如果目标版本确实不存在,
composer show vendor/package能列出所有可用版本,别靠猜
复杂点在于:有些包用 replace 或 provide 声明替代关系,表面上 vendor/package 找不到,其实是被另一个包代理了——这时得看 composer show --tree 输出里的 (replaced) 标记。










