OpenCV 环境变量速查与调优指南

注意：OPENCV_OPENCL_DEVICE 是选择哪个设备跑计算的关键，格式为 <Platform>:<GPU|CPU|ACCELERATOR|nothing=GPU/CPU>:<deviceName>，比如 NVIDIA:GPU:GeForce GTX 1080 或 Intel(R) OpenCL HD Graphics:GPU:。留空则使用默认设备。

共享虚拟内存 (SVM)

默认禁用，通常无需改动。相关变量如下：

跟踪与剖析

主要用于性能分析和调试，配合性能工具使用。

缓存目录

OpenCV 会在临时目录存放下载数据、OpenCL 内核缓存等，可通过以下变量调整位置。

默认临时目录在 Windows 下是 %TMP%，Linux/macOS 依次尝试 $XDG_CACHE_HOME、$HOME/.cache、/var/tmp。

DNN 后端

如果你用 OpenCV 的 DNN 模块，这些变量会影响推理引擎、OpenVINO、ONNX 解析和 OpenCL 后端行为。

核心模块 & 图像处理

这部分涵盖基本行为、图像读写限制和一些特殊优化开关。

核心

图像预处理

编解码

G-API

如果你的应用使用了 OpenCV 的 Graph API，几个配置变量。

视频 I/O

使用 VideoCapture/VideoWriter 时，可以通过环境变量向 FFmpeg、GStreamer、MFX 等后端传递额外参数。

测试

运行 OpenCV 测试时，可以用这些变量定位数据、控制行为。

如何设置

上面的变量可以通过三种常用方式生效：

命令行临时赋值
适用于快速实验：

export OPENCV_OPENCL_DEVICE="NVIDIA:GPU:GeForce GTX 1080"
export OPENCV_OPENCL_CACHE_ENABLE=1
./your_app

代码里硬编码
在初始化 OpenCV 前调用 setenv（Unix）或 _putenv_s（Windows）：

#include <opencv2/core.hpp>
#ifdef _WIN32
    _putenv_s("OPENCV_OPENCL_CACHE_ENABLE", "1");
#else
    setenv("OPENCV_OPENCL_CACHE_ENABLE", "1", 1);
#endif

系统 / 用户环境变量
在操作系统设置中永久添加，所有进程都会继承。这种方式适合生产环境，但要小心影响面，避免覆盖其他应用的设置。

正确组合这些变量，能让 OpenCL 加速更稳定，缓存管理更智能，视频 I/O 更贴近具体场景。多数时候只需要调整设备选择和缓存开关就能获得可观提升。