如何在Docker中成功构建VCPKG包？构建失败排查求助

1. 解决Ninja版本冲突问题 #

你的Dockerfile中手动编译安装了Ninja 1.10.2，但vcpkg会自动下载并使用内置的Ninja 1.12.1，版本不一致可能导致构建异常。可以通过两种方式解决：

• 取消注释ENV VCPKG_FORCE_SYSTEM_BINARIES=0，改为ENV VCPKG_FORCE_SYSTEM_BINARIES=1，强制vcpkg使用系统安装的Ninja
• 直接删除手动编译Ninja的步骤（步骤3），使用系统默认的ninja-build包即可，避免版本冲突

2. 补充Boost构建所需的系统依赖 #

Ubuntu 22.04默认缺少部分Boost构建依赖，在apt-get install的包列表中添加以下内容：

libbz2-dev \
liblzma-dev \
libicu-dev \

3. 调整并发构建参数 #

VCPKG_MAX_CONCURRENCY=10可能超出容器可用资源，导致构建过程中资源耗尽失败。建议改为根据容器CPU核心数自动设置：

ENV VCPKG_MAX_CONCURRENCY=$(getconf _NPROCESSORS_ONLN)

也可以根据实际资源情况手动调低数值（如4）

4. 清理vcpkg缓存避免旧数据干扰 #

在执行vcpkg install前添加清理缓存的命令，消除旧缓存导致的异常：

RUN vcpkg clean --all

5. 简化CMake安装步骤 #

Ubuntu 22.04默认的CMake 3.22版本已经满足vcpkg的最低要求，可以删除手动编译CMake的步骤，直接使用系统包，减少构建复杂度和潜在问题

6. 定位具体错误原因 #

根据错误提示，查看vcpkg生成的详细日志文件，获取Ninja执行失败的具体信息：

# 构建失败后进入容器查看日志
docker run -it --rm <你的镜像ID> bash
cat /vcpkg/buildtrees/boost-filesystem/config-x64-linux-rel-ninja.log

日志会明确显示失败原因，比如缺少特定依赖、编译参数错误等

内容的提问来源于stack exchange，提问作者coach