如何在Jupyter Notebook的IJava内核环境中配置运行OpenCV

前置检查 #

• 确认IJava内核版本匹配JDK版本，要求JDK11及以上，IJava内核>=1.3.0
• 确认本地OpenCV版本和要导入的jar包、本地动态库版本完全一致，版本不兼容是90%的配置失败原因

配置步骤 #

步骤1：获取OpenCV对应Java绑定文件 #

你需要找到两个核心文件：

• OpenCV的Java jar包：通常在OpenCV安装目录下的build/java目录，文件名为opencv-<版本号>.jar，例如opencv-480.jar
• 对应系统的动态链接库：
  • Windows系统：build/java/x64/opencv_java<版本号>.dll
  • MacOS系统：build/java/libopencv_java<版本号>.dylib
  • Linux系统：build/java/libopencv_java<版本号>.so

如果使用的是Anaconda环境安装的OpenCV，上述两个文件通常在Anaconda安装目录下的pkgs/opencv-<版本号>/share/java/opencv4/路径下，可以优先到该路径查找。

步骤2：在Jupyter Notebook中导入依赖 #

打开搭载IJava内核的Notebook，第一个代码块执行以下内容，注意替换成你本地的实际文件路径：

// 加载本地OpenCV jar包
%jars /your/actual/path/opencv-<版本号>.jar

// 加载对应动态链接库
System.load("/your/actual/path/libopencv_java<版本号>.xxx");

步骤3：验证配置是否生效 #

新建代码块运行验证代码：

import org.opencv.core.Core;
import org.opencv.core.Mat;

public class TestOpenCV {
    public static void main(String[] args) {
        System.loadLibrary(Core.NATIVE_LIBRARY_NAME);
        Mat mat = Mat.eye(3, 3, org.opencv.core.CvType.CV_8UC1);
        System.out.println("OpenCV加载成功，测试矩阵输出：\n" + mat.dump());
    }
}
new TestOpenCV().main(null);

如果输出3×3的单位矩阵，说明配置成功。

常见故障排查 #

• 提示找不到类：检查jar包路径是否正确，路径不要包含中文或空格
• 提示找不到Native库：检查动态库路径是否正确，且动态库版本和jar包版本完全一致
• Anaconda环境下找不到对应文件：可以直接从OpenCV官网下载对应版本的预编译包，使用包内的jar和动态库文件即可，无需强制使用Anaconda安装的OpenCV文件

内容的提问来源于stack exchange，提问作者Tom C