第一步，准备工作：
（Node.js, VS2022, Python）
第 2 步：下载并安装 OpenCV
- 前往 OpenCV 官网发布页。
- 下载
Windows版安装包（例如opencv-4.8.0-windows.exe）。 - 运行该文件，将其解压到
C:\opencv（这是最可靠的路径，确保没有空格和中文）。
第 3 步：配置系统环境变量（核心步骤）
打开“系统属性” -> “高级” -> “环境变量”，在 系统变量 中新建或修改以下变量（根据你的实际路径调整，vc17对应VS2022）：
| 变量名应设置的精确值作用 | ||
OPENCV4NODEJS_DISABLE_AUTOBUILD | 1 | 强制禁用自动构建，必须设置 |
OPENCV_INCLUDE_DIR | C:\opencv\build\include | 提供头文件位置 |
OPENCV_LIB_DIR | C:\opencv\build\x64\vc17\lib | 提供库文件位置 |
OPENCV_BIN_DIR | C:\opencv\build\x64\vc17\bin | 提供运行时 DLL 位置 |
关键检查：请务必打开 C:\opencv\build\x64\ 文件夹，确认里面的子文件夹名称是 vc17（对应 VS2022）还是 vc16（对应 VS2019），并据此修改上表中的路径。
最后，将 %OPENCV_BIN_DIR% 添加到系统的 Path 变量中。
完成后，检查 OpenCV .lib 文件是否存在：
- powershell
# 运行此命令，应该列出很多 .lib 文件
dir “C:\Users\98317\opencv\build\x64\vc16\lib\*.lib”
- 在安装命令中一次性设置所有必需的环境变量：
- 这是最彻底的方案，确保构建进程能获取所有信息。
- powershell
$env:OPENCV4NODEJS_DISABLE_AUTOBUILD=1
$env:OPENCV_INCLUDE_DIR=“C:\Users\98317\opencv\build\include”
$env:OPENCV_LIB_DIR=“C:\Users\98317\opencv\build\x64\vc16\lib”
$env:OPENCV_BIN_DIR=“C:\Users\98317\opencv\build\x64\vc16\bin”
npm install --msvs_version=2022 @u4/opencv4nodejs