使用vcpkg编译依赖OpenCV的Linux应用时LibCap编译失败的问题求助

算力阿峰

2026-4-8

vcpkg编译依赖OpenCV的Linux应用时LibCap编译失败的问题求助

看起来你在Linux环境下用vcpkg配合CMake构建依赖OpenCV的应用时，卡在了libcap包的编译环节，还碰到了CMake构建工具和编译器识别的问题。我来帮你一步步排查解决：

先确认下你的配置文件（方便参考）

CMakeLists.txt

cmake_minimum_required(VERSION 3.29)
# Enable vcpkg manifest mode
if(DEFINED ENV{VCPKG_ROOT})
    set(CMAKE_TOOLCHAIN_FILE "$ENV{VCPKG_ROOT}/scripts/buildsystems/vcpkg.cmake" CACHE STRING "")
    # Set a suitable triplet for Linux (adjust if using a different architecture)
    set(VCPKG_TARGET_TRIPLET "x64-linux" CACHE STRING "")
endif()

project(opencv_app)

# Enable C++17
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

message(STATUS "Using vcpkg toolchain file: ${CMAKE_TOOLCHAIN_FILE}")
message(STATUS "Using vcpkg triplet: ${VCPKG_TARGET_TRIPLET}")

# Add executable
add_executable(opencv_app main.cpp)

# Find OpenCV package via vcpkg
find_package(OpenCV REQUIRED)
target_link_libraries(opencv_app PRIVATE ${OpenCV_LIBS})
target_include_directories(opencv_app PRIVATE ${OpenCV_INCLUDE_DIRS})

vcpkg.json

{
  "name": "opencv-app",
  "version": "0.1.0",
  "dependencies": [
    {
      "name": "opencv",
      "default-features": false,
      "features": [
        "jpeg"
      ]
    }
  ]
}

错误根源分析

从日志里能揪出两个核心问题：

libcap编译失败：vcpkg调用make编译libcap时执行出错，大概率是系统缺了基础构建工具
CMake环境不完整：CMake找不到Unix Makefiles对应的构建程序，连C/C++编译器都没识别到，这直接导致后续构建链断裂

分步解决办法

1. 先补全系统的基础编译工具链

Linux下搞编译，基础工具是刚需，先装了再说：

Debian/Ubuntu 系列：

sudo apt update && sudo apt install build-essential libtool autoconf automake

RHEL/CentOS/Fedora 系列：

sudo dnf groupinstall "Development Tools"
sudo dnf install libtool autoconf automake

2. 清理vcpkg的损坏缓存，重新来过

之前libcap的编译缓存可能已经损坏，清掉再试：

# 清理vcpkg的构建缓存
vcpkg clean

# 删掉之前的CMake构建目录，重新配置
rm -rf build && mkdir build && cd build
cmake ..
cmake --build .

3. 手动指定CMake的构建工具（保险操作）

如果装完工具还是提示CMAKE_MAKE_PROGRAM没设置，直接在CMake命令里硬指定路径，避免它自动查找出错：

cmake -B build -DCMAKE_MAKE_PROGRAM=/usr/bin/make -DCMAKE_C_COMPILER=/usr/bin/gcc -DCMAKE_CXX_COMPILER=/usr/bin/g++ ..

4. 把vcpkg更新到最新版本

vcpkg的端口文件（各包的编译脚本）可能存在旧bug，更新到最新能解决不少已知的编译问题：

cd $VCPKG_ROOT
git pull
vcpkg update

5. 单独编译libcap查看详细日志（排查深层问题）

如果还是卡libcap，单独安装它并开启debug日志，能看到具体哪一步出错：

vcpkg install libcap:x64-linux --debug

debug日志会输出更细节的编译过程，比如是否缺少某个依赖文件、目录权限不足等问题都会明确提示。

额外提醒

确保你的用户对vcpkg目录、项目目录有读写权限，避免因权限不足导致编译失败
检查磁盘空间，OpenCV及依赖包编译需要占用较多磁盘空间
若你使用的CMake版本过新（比如3.29），可以尝试降级到稳定版本（如3.28），避免和vcpkg出现兼容性问题

内容来源于stack exchange