如何在Xcode中配置Homebrew安装的OpenCV头文件（M2 MacBook Air）

1. 确认OpenCV的准确路径 #

先在终端执行命令，获取OpenCV的完整安装路径：
brew info opencv
输出里会显示类似/opt/homebrew/Cellar/opencv/[具体版本号]的路径，比如/opt/homebrew/Cellar/opencv/4.8.1，把这个路径记下来。

2. 配置头文件搜索路径 #

• 打开你的Xcode命令行项目，选中左侧导航栏最顶部的项目根节点。
• 切换到「Build Settings」标签页，在搜索框输入Header Search Paths。
• 双击该选项的输入区域，添加OpenCV路径下的include/opencv4目录，比如：
  /opt/homebrew/Cellar/opencv/4.8.1/include/opencv4
  勾选后面的「Recursive」选项，确保Xcode能找到所有嵌套的头文件。

3. 配置库文件搜索路径 #

• 同样在「Build Settings」里搜索Library Search Paths。
• 添加OpenCV路径下的lib目录，比如：
  /opt/homebrew/Cellar/opencv/4.8.1/lib

4. 链接OpenCV动态库 #

• 切换到「Build Phases」标签页，展开「Link Binary With Libraries」。
• 点击左下角的+号，选择「Add Other...」→「Add Files...」。
• 导航到刚才的lib文件夹，选择所有.dylib后缀的文件（也可以按需选择核心库，比如libopencv_core.dylib、libopencv_imgcodecs.dylib等），添加到项目中。
• 嫌麻烦的话，也可以点击+后选「Add Other...」，按Cmd+Shift+G直接输入OpenCV的lib路径快速定位。

5. 测试配置是否生效 #

在main.cpp里写入测试代码：

#include <opencv2/opencv.hpp>
#include <iostream>

int main() {
    cv::Mat img = cv::imread("test.jpg");
    if (img.empty()) {
        std::cout << "无法读取图片" << std::endl;
        return 1;
    }
    cv::imshow("测试窗口", img);
    cv::waitKey(0);
    return 0;
}

编译运行项目，记得把test.jpg放在项目运行目录或者用完整路径，能正常显示图片就说明配置成功。

小技巧（避免版本更新后改路径） #

如果后续用Homebrew更新OpenCV，不想手动改Xcode路径，可以用Homebrew的软链接路径/opt/homebrew/opt/opencv代替具体版本路径：

• 头文件路径改为：/opt/homebrew/opt/opencv/include/opencv4
• 库文件路径改为：/opt/homebrew/opt/opencv/lib

内容的提问来源于stack exchange，提问作者Mykyta Serebriakov