Docker中构建运行C++ OpenCV代码的头文件依赖问题

问题根源 #

你的编译命令g++ -o wav wav.cpp未指定OpenCV的头文件搜索路径和需要链接的库，导致编译器找不到头文件；后续即使头文件问题解决，也会出现库链接错误。另外，Dockerfile开头的两个FROM指令存在逻辑问题：第二个FROM ubuntu会完全覆盖第一个nvidia/cuda镜像的环境，若你需要CUDA加速的OpenCV，这个错误会直接导致CUDA支持失效。

修复步骤 #

1. 修正基础镜像（可选但关键）

如果需要基于CUDA环境运行OpenCV，删除第二个FROM ubuntu，保留NVIDIA的基础镜像：

FROM nvidia/cuda:11.5.0-cudnn8-runtime-ubuntu20.04

ARG DEBIAN_FRONTEND=noninteractive
# 后续安装命令不变

2. 确保OpenCV生成pkg-config配置（可选）

编译OpenCV时添加OPENCV_GENERATE_PKGCONFIG=ON参数，确保生成pkg-config所需的配置文件，方便后续编译自动获取参数：

RUN git clone https://github.com/opencv/opencv.git && \
    cd /opencv && mkdir build && cd build && \
    cmake -D CMAKE_BUILD_TYPE=Release \
          -D CMAKE_INSTALL_PREFIX=/usr/local \
          -D OPENCV_GENERATE_PKGCONFIG=ON .. && \
    make -j"$(nproc)" && \
    make install && ldconfig

3. 选择以下一种方式编译代码

方式一：用pkg-config增强g++命令

修改Dockerfile末尾的编译指令，通过pkg-config自动获取OpenCV的头文件路径和链接库参数：

COPY . .

# 使用pkg-config提供的参数编译
RUN g++ -o wav wav.cpp $(pkg-config --cflags --libs opencv4)

方式二：用CMake构建（推荐复杂项目）

1. 在项目目录下创建CMakeLists.txt文件：

cmake_minimum_required(VERSION 3.10)
project(wav_demo)

# 查找系统中的OpenCV库
find_package(OpenCV REQUIRED)

# 生成可执行文件
add_executable(wav wav.cpp)

# 链接OpenCV库
target_link_libraries(wav ${OpenCV_LIBS})

2. 修改Dockerfile末尾的内容为：

COPY . .

# 使用CMake构建
RUN mkdir build && cd build && cmake .. && make -j$(nproc)
# 编译完成后，可执行文件位于build/wav

验证运行 #

构建镜像后，运行容器时可直接执行生成的可执行文件：

docker run --rm [你的镜像名] ./wav

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