Vcpkg+CMake交叉编译时指定对应架构库的问题与解决

使用Vcpkg+CMake进行跨平台开发，在WSL完成x64架构示例代码后，切换到arm-linux-gnueabihf交叉编译工具链时遇到以下问题：

• CMake报错找不到与ARM架构兼容的plog库配置文件，仅能识别x64-linux版本的plogConfig.cmake
• 删除x64-linux版本plog后，CMake直接提示找不到plog配置文件

已完成的前置操作：

1. 在[vcpkgroot]/triplets目录下创建arm-linux-gnueabihf.cmake，内容如下：

set(VCPKG_TARGET_ARCHITECTURE arm)
set(VCPKG_CMAKE_SYSTEM_NAME Linux)
set(VCPKG_CMAKE_SYSTEM_PROCESSOR arm)
set(VCPKG_CRT_LINKAGE dynamic)
set(VCPKG_LIBRARY_LINKAGE dynamic)

2. 通过vcpkg install plog:arm-linux-gnueabihf成功安装ARM版本plog，/vcpkg/installed目录下已有arm-linux-gnueabihf、vcpkg、x64-linux三个文件夹

手动指定plog_DIR路径后编译可成功，但希望找到更规范的自动适配方法。

以下是无需手动指定库路径的标准实现方式：

1. 直接通过CMake参数指定Vcpkg工具链及目标Triplet #

在CMake配置阶段，直接传入Vcpkg工具链文件和目标架构Triplet，Vcpkg会自动匹配对应架构的库路径：

cmake .. -DCMAKE_TOOLCHAIN_FILE=[vcpkgroot]/scripts/buildsystems/vcpkg.cmake -DVCPKG_TARGET_TRIPLET=arm-linux-gnueabihf -DCMAKE_C_COMPILER=arm-linux-gnueabihf-gcc -DCMAKE_CXX_COMPILER=arm-linux-gnueabihf-g++

• -DVCPKG_TARGET_TRIPLET：明确指定目标架构的triplet，Vcpkg会自动从installed/arm-linux-gnueabihf路径搜索依赖库
• -DCMAKE_C_COMPILER/-DCMAKE_CXX_COMPILER：指定交叉编译工具链的对应编译器

2. 定制CMake交叉编译工具链文件（适合复杂场景） #

如果需要更定制化的交叉编译配置，可以创建单独的CMake工具链文件（例如arm-linux-gnueabihf.toolchain.cmake），内容示例：

# 指定交叉编译器
set(CMAKE_C_COMPILER arm-linux-gnueabihf-gcc)
set(CMAKE_CXX_COMPILER arm-linux-gnueabihf-g++)

# 绑定Vcpkg目标triplet与工具链
set(VCPKG_TARGET_TRIPLET arm-linux-gnueabihf)
set(CMAKE_TOOLCHAIN_FILE [vcpkgroot]/scripts/buildsystems/vcpkg.cmake CACHE STRING "Vcpkg toolchain file")

配置CMake时直接指定该工具链文件即可：

cmake .. -DCMAKE_TOOLCHAIN_FILE=./arm-linux-gnueabihf.toolchain.cmake

3. 版本兼容性检查 #

• 确保Vcpkg版本不低于2023.08，旧版本对交叉编译triplet的路径匹配支持不完善
• CMake版本建议不低于3.16，更好支持工具链文件的架构检测与路径自动配置

核心原理 #

Vcpkg通过VCPKG_TARGET_TRIPLET变量匹配对应的库安装目录，当CMake基于Vcpkg工具链构建时，会自动将CMAKE_PREFIX_PATH设置为对应triplet的installed/[triplet]/lib/cmake、installed/[triplet]/share等路径，find_package会自动从这些路径中搜索对应架构的库配置文件，无需手动指定XXX_DIR。

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