OpenCV 环境变量配置与性能调优指南
1. 概述
OpenCV（Open Source Computer Vision Library）是一个跨平台的计算机视觉库，支持 C++、Python、Java 等语言。为了适应不同的运行环境并优化性能，OpenCV 提供了丰富的环境变量接口。通过配置这些变量，开发者可以控制调试输出、修改默认路径、调整算法行为以及启用或禁用特定的硬件加速功能。
本文档详细列出了 OpenCV 的核心环境变量，涵盖设置方法、类型说明、具体参数详解及最佳实践，帮助开发者在 Windows、Linux 及 Python 环境中高效使用 OpenCV。
2. 环境变量的设置方法
2.1 Windows 系统
命令行设置
在终端或批处理文件（.bat）中，可以使用 set 命令临时设置环境变量：
set OPENCV_LOG_LEVEL=DEBUG
set MY_ENV_VARIABLE=true
c:\my_app.exe
图形界面设置
- 打开'设置' -> '系统' -> '关于'。
- 点击右侧的'高级系统设置'。
- 在弹出的窗口中，点击'环境变量'按钮。
- 在'用户变量'或'系统变量'列表中，点击'新建'添加条目。
- 重启应用程序以生效。
2.2 Linux / macOS 系统
Shell 脚本设置
在终端或 shell 脚本中，使用 export 命令：
export OPENCV_LOG_LEVEL=DEBUG
export MY_ENV_VARIABLE=true
./my_app
单行命令执行
也可以作为单个命令的前缀直接执行：
OPENCV_LOG_LEVEL=DEBUG ./my_app
2.3 Python 环境
在 Python 代码中，可以通过 os.environ 字典设置环境变量。注意：必须在导入 cv2 模块之前设置，否则可能不生效。
import os
os.environ["OPENCV_LOG_LEVEL"] = "DEBUG"
os.environ["MY_ENV_VARIABLE"] = "true"
import cv2
# 在此之后设置的变量可能不起作用
2.4 IDE 与构建工具
- PyCharm/VS Code: 在运行配置（Run Configuration）中添加 Environment Variables。
- CMake: 在
CMakeLists.txt中使用add_definitions(-DVAR_NAME=value)或在运行时传递环境变量。 - Docker: 在
Dockerfile中使用ENV指令或在docker run时使用 参数。
