上一个教程: 在基于 Android 相机预览的 CV 应用中使用 OpenCL
下一个教程: ARM Linux 系统的交叉编译


原始作者	`@sajarindider`
兼容性	OpenCV >= 3.4

以下步骤已在 macOS (Mavericks) 上测试过，但也应该适用于其他版本。

必需软件包

CMake 3.9 或更高版本
Git
Python 3.x 和 NumPy 1.5 或更高版本

本教程假设您的机器上已安装 Python、NumPy 和 Git。

注意

macOS 12.2 (Monterey) 及更早版本：预装了 Python 2.7。
macOS 12.3 及更高版本：Python 2.7 已被移除，默认情况下不包含任何 Python 版本。

建议安装最新版本的 Python 3.x（至少 Python 3.8），以与最新的 OpenCV Python 绑定兼容。

注意: 如果您已安装 Xcode 和 Xcode 命令行工具，则 Git 已经可以在您的机器上使用。

安装 CMake

找到适合您系统的版本，并从他们的发布页面下载 CMake
安装 .dmg 包并从应用程序启动它。这将为您提供 CMake 的 UI 应用程序
从 CMake 应用程序窗口中，选择菜单 Tools --> How to Install For Command Line Use。然后，按照弹窗中的说明操作。
默认情况下，安装文件夹将为 /usr/local/bin/。通过选择 Install command line links 完成安装。
运行以下命令测试 CMake 是否正确安装

cmake --version

注意

您可以使用 Homebrew 通过以下命令安装 CMake

@code{.bash}
brew install cmake
@endcode

获取 OpenCV 源代码

您可以使用最新的稳定 OpenCV 版本，也可以从我们的 Git 仓库中获取最新的快照。

获取最新的稳定 OpenCV 版本

转到我们的 OpenCV 发布页面。
下载最新版本的源代码存档（例如，OpenCV 4.x）并解压缩它。

从 Git 仓库获取最前沿的 OpenCV

启动 Git 客户端并克隆 OpenCV 仓库。如果您需要 OpenCV contrib 仓库中的模块，也请克隆它。

例如

@code{.bash}
cd ~/<your_working_directory>
git clone https://github.com/opencv/opencv.git
git clone https://github.com/opencv/opencv_contrib.git
@endcode

使用 CMake 从源代码构建 OpenCV

创建一个临时目录，我们将其表示为 build_opencv，您希望将生成的 Makefiles、项目文件以及对象文件和输出二进制文件放入其中，然后进入该目录。

例如

mkdir build_opencv

cd build_opencv

注意
保持源代码目录的清洁是一个好习惯。在源树之外创建构建目录。
配置。运行 cmake [<一些可选参数>] <OpenCV 源代码目录的路径>

例如

cmake -DCMAKE_BUILD_TYPE=Release -DBUILD_EXAMPLES=ON ../opencv

或者，您可以使用 CMake GUI (cmake-gui)
- 将 OpenCV 源代码路径设置为，例如 /Users/your_username/opencv
- 将二进制构建路径设置为您的 CMake 构建目录，例如 /Users/your_username/build_opencv
- 设置可选参数
- 运行: "Configure"
- 运行: "Generate"
一些参数的描述
- 构建类型: -DCMAKE_BUILD_TYPE=Release (或 Debug)。
- 包含额外的模块: 如果您克隆了 opencv_contrib 仓库并且想要包含它的模块，请设置
  
  -DOPENCV_EXTRA_MODULES_PATH=../opencv_contrib/modules
- 设置 -DBUILD_DOCS=ON 以构建文档 (需要 doxygen)
- 设置 -DBUILD_EXAMPLES=ON 以构建所有示例
[可选] 构建 python。设置以下 python 参数
- -DPYTHON3_EXECUTABLE=$(which python3)
- `-DPYTHON3_INCLUDE_DIR=$(python3 -c "from sysconfig import get_paths as gp; print(gp()['include’])")`
- `-DPYTHON3_NUMPY_INCLUDE_DIRS=$(python3 -c "import numpy; print(numpy.get_include())")`
  注意
  Python 2 已经结束了它的生命周期。建议使用 Python 3 来构建 Python 绑定。
构建。从构建目录执行 make，建议在多个线程中执行此操作

例如

make -j$(sysctl -n hw.ncpu) # 使用所有可用的 CPU 核心运行构建
构建完成后，您可以使用以下命令在系统范围内安装 OpenCV

sudo make install
要在您基于 CMake 的项目中通过 find_package(OpenCV) 使用 OpenCV，请指定指向构建或安装目录的 OpenCV_DIR 变量。

例如

cmake -DOpenCV_DIR=~/build_opencv ..

验证 OpenCV 安装

构建（并可选安装）OpenCV 后，您可以通过使用 Python 检查版本来验证安装

@code{.bash}
python3 -c "import cv2; print(cv2.__version__)"
@endcode

此命令应输出您已安装的 OpenCV 版本。

注意: 您还可以使用诸如 Homebrew 或 pip 之类的软件包管理器来仅安装 OpenCV 的发布版本（不是最前沿的版本）。

通过 Homebrew 安装

例如

brew install opencv
通过 pip 安装

例如

pip install opencv-python

注意
要访问 opencv_contrib 中的额外模块，请使用 pip install opencv-contrib-python 安装 opencv-contrib-python 包。