使用Xcode构建OpenCV遇报错：无法找到opencv2/opencv.hpp文件

我来帮你搞定这个头疼的路径问题！我之前在配置OpenCV和Xcode的时候也踩过类似的坑，主要是Xcode的搜索路径没配置到位，咱们一步步来排查：

第一步：确认OpenCV的安装路径 #

首先打开终端，输入命令确认Homebrew安装的OpenCV具体位置：

brew info opencv

注意区分芯片架构的路径差异：Intel芯片的OpenCV通常在/usr/local/Cellar/opencv/4.0.1，M系列芯片则在/opt/homebrew/Cellar/opencv/4.0.1，重点记下include和lib文件夹的完整路径。

第二步：配置Xcode的头文件搜索路径 #

1. 打开你的Xcode项目，选中左侧的项目目标（Target），切换到Build Settings标签页
2. 在搜索框输入Header Search Paths，双击右侧空白区域添加路径
3. 把刚才找到的OpenCV的include路径填进去（比如/usr/local/Cellar/opencv/4.0.1/include），然后勾选路径后面的Recursive（递归搜索能让Xcode自动找到opencv4子目录下的opencv2文件）

第三步：配置库文件搜索路径 #

1. 同样在Build Settings里搜索Library Search Paths
2. 添加OpenCV的lib文件夹路径（比如/usr/local/Cellar/opencv/4.0.1/lib），建议也勾选Recursive

第四步：检查链接的库是否正确 #

1. 切换到Build Phases标签页，找到Link Binary With Libraries
2. 确保添加的是具体的OpenCV库文件（比如libopencv_core.4.0.1.dylib、libopencv_highgui.4.0.1.dylib等），而不是只添加一个笼统的libopencv.dylib——单个总库可能无法覆盖所有依赖模块
3. 如果你不确定要加哪些库，可以直接把lib文件夹下所有以libopencv开头的.dylib文件都加进去（至少添加代码会用到的模块）

第五步：调整代码中的include语句 #

你的代码里写的是：

#include <opencv4/opencv2/opencv.hpp>

如果已经配置了正确的头文件搜索路径（包含到include目录），其实可以简化为：

#include <opencv2/opencv.hpp>

因为opencv4是include目录下的子文件夹，递归搜索会自动定位到它。当然如果你坚持原来的写法，只要路径配置正确也没问题。

第六步：清理缓存重新构建 #

最后，点击Xcode顶部菜单的Product -> Clean Build Folder（快捷键Shift + Command + K），然后再点击Build，避免旧缓存干扰。

如果还是不行，建议在终端输入opencv_version确认当前安装的OpenCV版本是不是4.0.1，确保和你添加的.dylib版本一致。

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