用C++调OpenCV核心三步：装库、配路径（包含目录和库目录）、写代码（含头文件并链接对应lib）；Windows推荐官方预编译包，注意路径无中文空格、平台选x64、dll需置于exe同目录或PATH中。
用 C++ 调 OpenCV，核心就三步：装好 OpenCV 库、让编译器找得到头文件和链接库、写代码时正确包含和调用。不复杂，但容易卡在路径或链接环节。
下载与编译 OpenCV（Windows + MinGW/MSVC）
推荐直接用官方预编译包，省去编译麻烦。去 opencv.org 下载带 vc15/vc16/vc17 后缀的 Windows 版（对应 VS2019/2022），或选 mingw 版（配 Code::Blocks/Qt Creator）。解压到不含中文和空格的路径，比如 C:\opencv。
关键目录说明：
- build\include → 头文件所在，后续要加进项目 include 目录
- build\x64\vc17\lib（或 mingw\x64\lib）→ 静态/动态链接库位置
- build\x64\vc17\bin → dll 文件，运行时必须能被找到（放 exe 同目录 或 加入系统 PATH）
VS2022 中配置 C++ 项目（以空项目为例）
右键项目 → 属性 → 在「配置属性」下逐项设置：
立即学习“C++免费学习笔记（深入）”；
- C/C++ → 常规 → 附加包含目录：填 C:\opencv\build\include
- 链接器 → 常规 → 附加库目录：填 C:\opencv\build\x64\vc17\lib
- 链接器 → 输入 → 附加依赖项：填 opencv_world480.lib（版本号按你下的改，如 490；Debug 模式用 opencv_world480d.lib）
生成模式选 x64，别用 Win32。dll 文件复制到 输出目录（如 Debug/） 下，否则运行时报“找不到 opencv_worldxxx.dll”。
简单代码验证是否成功
新建 main.cpp，粘贴以下代码：
基于 AIOZ Stream API 的免费音频上传技能，通过三步流程（Create → Upload Part → Complete）将本地音频文件上传至 AIOZ 流媒体平台。支持默认快速上传方式，使用默认编码配置，上传完成后返回 HLS 流媒体播放链接。使用 API Key (stream-publ...)进行认证。
#include <opencv2/opencv.hpp>
#include <iostream>
int main() {
cv::Mat img = cv::imread("test.jpg");
if (img.empty()) {
std::cout << "图片加载失败，请确认路径\n";
return -1;
}
cv::imshow("Demo", img);
cv::waitKey(0);
return 0;
}
注意：
- 确保当前工作目录下有 test.jpg，或写绝对路径
- 如果报 LNK2019，检查 lib 名称、平台（x64）、Debug/Release 是否匹配
- 如果窗口一闪而过，说明图片没读到，先用绝对路径排查
常见问题速查
报错“无法打开包括文件：opencv2/opencv.hpp” → 包含目录路径错，或没加 \include
报错“LNK1104：无法打开文件 opencv_worldxxx.lib” → 库目录路径不对，或 lib 名字拼错（少 d、版本号不对）
运行时报“缺少 opencv_worldxxx.dll” → 把对应 dll 从 bin 目录拷到 exe 所在文件夹
imshow 窗口空白或崩溃 → 图片路径错误 / 格式不支持 / OpenCV 没启用 GUI 模块（预编译版默认开启）
基本上就这些。配通一次，后续新建项目复制属性页就行。OpenCV 的 C++ 接口稳定，入门从 imread + imshow + waitKey 开始最直观。
