Ubuntu下VSCode用VCPKG装库失败：bzip2编译报错BUILD_FAILED

云原生阿岚

2026-7-25

解决VCPKG安装zstr时bzip2编译失败的问题

首先纠正一个误区：iostream、string是C++标准库，无需通过vcpkg安装，系统自带的GCC/G++编译器已经包含这些库，直接在代码中#include即可使用。

针对bzip2:x64-linux BUILD_FAILED的问题，尝试以下步骤：

安装Ubuntu基础编译依赖：
```
sudo apt update && sudo apt install build-essential cmake libssl-dev
```
这些是vcpkg编译绝大多数库的必备依赖，缺失会导致各类编译失败。
清理vcpkg的错误缓存与残留包：
```
./vcpkg/vcpkg remove --purge bzip2
./vcpkg/vcpkg clean
```
彻底清除之前编译bzip2时留下的错误文件与缓存。
尝试跳过源码编译，直接使用系统库安装zstr：
```
./vcpkg/vcpkg install zstr --no-build-from-source
```
该参数会让vcpkg优先使用系统已安装的依赖库，而非自行编译bzip2。
若仍失败，手动安装系统级bzip2开发库：
```
sudo apt install libbz2-dev
```
安装后重新执行./vcpkg/vcpkg install zstr，vcpkg会自动检测并使用系统提供的bzip2库。