C++本地配置OpenCV

整个流程 "从下载源码到编译完成并配置 VSCode" 的完整操作步骤

一.下载 OpenCV 源码包

1. 打开浏览器，访问：

https://github.com/opencv/opencv/releases

https://github.com/opencv/opencv/tree/4.10.0

2. 找到 v4.10.0 版本（最新稳定版）

• 点击 opencv-4.10.0.zip 下载（源码包）

注意：不要下载 opencv-4.10.0-ohos.zip，那是 OpenHarmony 专用的！

3. 下载完成后，保存到：

E:\app\VSCode\RTS_Daily\C_text\OpenCV

假设你下载的文件名为：opencv-4.10.0.zip

二.解压源码到指定目录

1. 右键点击 opencv-4.10.0.zip

选择 "解压到当前文件夹" 或使用解压工具（如 7-Zip）

2. 解压后，你会看到一个文件夹：

opencv-4.10.0

3. 把这个文件夹 复制到：

E:\app\VSCode\RTS_Daily\C_text\OpenCV

最终结构：

E:\app\VSCode\RTS_Daily\C_text\OpenCV
├── opencv-4.10.0\         ← 源码
├── opencv-4.10.0.zip      ← 下载的源码包（可删）
└── （其他文件）

---

三.安装编译依赖（必须！）

1. 安装 CMake

• 下载地址：https://cmake.org/download/
• 安装时 勾选：Add CMake to PATH
• 推荐安装 CMake 3.20+

2. 安装 Visual Studio Build Tools

• 下载地址：https://visualstudio.microsoft.com/visual-cpp-build-tools/
• 安装 C++ build tools
• 确保包含：
  • MSVC 编译器（x64/x86）
  • Windows SDK
  • CMake Tools（自动安装）

安装完成后，打开 CMD 或 VSCode 终端，运行：

cmake --version
cl.exe

如果能看到版本号，说明安装成功！

四.创建 build 编译目录

在 opencv-4.10.0 文件夹下创建一个 构建目录：

E:\app\VSCode\RTS_Daily\C_text\OpenCV\opencv-4.10.0\build

这个目录专门用于编译，不要直接在源码目录里编译！

---

五.使用 CMake 配置编译

1. 打开 VSCode 终端（或 CMD）

cd E:\app\VSCode\RTS_Daily\C_text\OpenCV\opencv-4.10.0\build

2. 运行 CMake 命令（推荐配置）

cmake -G "Visual Studio 17 2022" -A x64 ^
-DCMAKE_INSTALL_PREFIX=E:\app\VSCode\RTS_Daily\C_text\OpenCV\install ^
-DCMAKE_BUILD_TYPE=Release ^
-DOPENCV_ENABLE_NONFREE=ON ^
-DBUILD_EXAMPLES=ON ..

说明：

• -G "Visual Studio 17 2022"：生成 VS 2022 项目
• -A x64：64 位编译
• CMAKE_INSTALL_PREFIX：安装路径（输出 .lib、.dll）
• BUILD_EXAMPLES=ON：编译示例代码（可选）
• OPENCV_ENABLE_NONFREE=ON：启用非免费模块（如 SIFT、SURF）

⚠️ 如果你不需要 GPU 支持，可以跳过 WITH_CUDA 等选项。

---

六.编译 OpenCV（耗时约 10~30 分钟）

1. 在 build 目录下运行：

cmake --build . --config Release --target INSTALL

这个命令会：

• 编译 OpenCV 所有模块（core、imgproc、highgui 等）
• 生成 .lib、.dll 文件
• 安装到 install 目录

---

七.最终文件结构（你该有的）

E:\app\VSCode\RTS_Daily\C_text\OpenCV
├── opencv-4.10.0\         ← 源码
├── build\                    ← 编译目录（可删或保留）
├── install\                  ← 编译后输出的库文件（核心！）
│   ├── include\             ← 头文件（opencv2/xxx.hpp）
│   ├── lib\                   ← .lib 文件（链接用）
│   └── bin\                   ← .dll 文件（运行时用）
├── opencv-4.10.0.zip      ← 下载包（可删）
└── （你后续的项目文件）

---

八.在 VSCode 中创建测试项目

1. 在 E:\app\VSCode\RTS_Daily\C_text\OpenCV 下创建：

• CMakeLists.txt
• main.cpp

CMakeLists.txt 内容：

cmake_minimum_required(VERSION 3.10)
project(OpenCVTest)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 设置 OpenCV 安装路径
set(OPENCV_DIR "E:/app/VSCode/RTS_Daily/C_text/OpenCV/install")

# 查找 OpenCV
find_package(OpenCV REQUIRED)

# 添加可执行文件
add_executable(main main.cpp)

# 链接 OpenCV
target_link_libraries(main ${OpenCV_LIBS})

main.cpp 内容：

#include <opencv2/opencv.hpp>
#include <iostream>

int main() {
    std::cout << "OpenCV version: " << CV_VERSION << std::endl;
    cv::Mat img = cv::Mat::zeros(200, 200, CV_8UC3);
    cv::imshow("Test", img);
    cv::waitKey(0);
    return 0;
}

---

最后一步：在 VSCode 中运行

1. 打开 VSCode，打开这个文件夹
2. 安装扩展：CMake Tools、C/C++（微软官方）
3. 按 Ctrl+Shift+P，输入 CMake: Configure
4. 等待自动配置
5. 输入 CMake: Build，编译成功后运行 main

如果弹出窗口并显示黑色图像，说明 OpenCV 成功编译并链接！

整理不易，诚望各位看官点赞 收藏 评论 予以支持，这将成为我持续更新的动力源泉。若您在阅览时存有异议或建议，敬请留言指正批评，让我们携手共同学习，共同进取，吾辈自当相互勉励！