Homebrew 是 macOS 上安装 OpenCV 最简单的方式,支持 C++ 和 Python 开箱即用;Java 或 Go 需额外配置:Java 要源码编译并启用 -DBUILD_opencv_java=ON,Go 需设置 PKG_CONFIG_PATH 并安装 gocv。
直接用 Homebrew 安装 OpenCV 是 macOS 上最省事的方式,尤其适合 C++ 和 Python 开发。Java 或 Go 用户需额外几步,但整体仍比源码编译简单得多。
安装 Homebrew(如果还没装)
新版 macOS(Catalina 及以后)默认用 zsh,推荐用最新脚本安装:
- 终端运行:/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
- 安装完成后,Homebrew 会提示是否自动配置路径。若没自动生效,检查 ~/.zshrc 是否含 export PATH="/opt/homebrew/bin:$PATH"(M1/M2 芯片)或 export PATH="/usr/local/bin:$PATH"(Intel 芯片)
- 运行 brew doctor 确认环境正常
安装 OpenCV(主流版本)
Homebrew 默认安装最新稳定版(目前是 opencv 4.x),命令简洁:
- brew install opencv
- 如需指定版本(例如 opencv@3),先查可用公式:brew search opencv,再安装:brew install opencv@3
- 安装位置通常为:/opt/homebrew/opt/opencv(M1/M2)或 /usr/local/opt/opencv(Intel)
验证与基础使用
装完就能快速验证是否可用:
- 运行 pkg-config --modversion opencv4(OpenCV 4)或 pkg-config --modversion opencv(OpenCV 3),应输出版本号
- C++ 编译时用:g++ `pkg-config --cflags --libs opencv4` test.cpp -o test
- Python 用户可直接 import cv2(Homebrew 安装的 opencv 自带 Python 绑定,前提是系统 Python 已被 brew 管理或已用 pip 安装对应 wheel)
Java 或 Go 开发者注意点
Homebrew 默认不编译 Java 支持或 Go 绑定,需手动补全:
-
Java:需从源码重装并开启 Java 构建:brew install --build-from-source opencv,且提前执行 brew edit opencv,将 -DBUILD_opencv_java=OFF 改为 ON;jar 包生成在 /opt/homebrew/Cellar/opencv/*/share/OpenCV/java/
-
Go:除了 brew install opencv,还需设置环境变量:export PKG_CONFIG_PATH="/opt/homebrew/opt/opencv/lib/pkgconfig:$PKG_CONFIG_PATH",再运行 go get -u gocv.io/x/gocv