上一個教程: 在基於 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 包。