答案:系统缺少解压工具导致Composer报错,需安装unzip或7z并配置环境变量。Windows用户应安装7-Zip并添加路径到PATH,macOS可通过Homebrew安装unzip和p7zip,Linux用户使用apt或yum安装对应包,安装后通过unzip -v或7z验证,最后重新运行Composer命令即可解决。

出现 "unzip/7z is not installed" 提示,说明你的系统缺少解压工具,而 Composer 在安装或更新包时需要调用这些工具来解压 ZIP 格式的压缩包。
解决方法
1. 安装 unzip 工具
根据你使用的操作系统,安装对应的解压工具:
Windows- 推荐安装 7-Zip(免费开源):https://www.php.cn/link/eba4b31af98c58b7cdb9cc785adc7627
- 安装完成后,确保 7-Zip 的路径(如
C:\Program Files\7-Zip)已添加到系统的 PATH 环境变量中 - 打开命令提示符输入
7z测试是否可用
- 通常自带
unzip,可运行以下命令检查:unzip -v - 如果没有,通过 Homebrew 安装:
brew install unzip - 如需 7z 支持:
brew install p7zip
- 安装 unzip 和 p7zip:
sudo apt updatesudo apt install unzip p7zip-full
- 使用 yum 或 dnf 安装:
sudo yum install unzip p7zip
或sudo dnf install unzip p7zip
2. 验证安装是否成功
在终端执行:
unzip -v
或
7z
如果显示版本信息,说明已正确安装。
3. 重新运行 Composer 命令
安装完成后,再次执行原来的 Composer 命令,例如:
composer install
错误应该已经消失。
额外建议
- 如果你使用的是共享主机或受限环境,联系管理员确认是否允许使用解压工具
- 某些 Composer 包强制依赖本地解压功能,无法跳过
- 确保 Composer 使用的是系统默认的 zip 解压方式,一般无需手动配置










