Mac端VSCode使用vcpkg引入OpenCV报无法打开源文件错误

头文件无法找到的问题来自三处配置错误：

• CMakeLists.txt 未声明OpenCV依赖，仅配置vcpkg工具链不会自动为项目关联已安装的第三方库
• c_cpp_properties.json 中手动填写的includePath多嵌套了一层opencv2目录，路径匹配逻辑错误
• 未指定CMake Tools为IntelliSense的配置提供方，加上当前使用的VSCode版本过旧，导致配置识别异常

• 第一步：修正CMakeLists.txt配置，补充OpenCV包查找和链接逻辑，替换为以下内容：

cmake_minimum_required(VERSION 3.0.0)
project(photoText VERSION 0.1.0)

# 查找vcpkg安装的OpenCV依赖
find_package(OpenCV REQUIRED)

add_executable(photoText main.cpp)
# 为可执行文件链接OpenCV的头文件目录与库文件
target_link_libraries(photoText PRIVATE ${OpenCV_LIBS})

注：原配置中可执行文件名带.cpp后缀属于不规范写法，建议移除，避免后续构建规则冲突

• 第二步：修正c_cpp_properties.json配置，删除错误的硬编码include路径，添加CMake配置提供者，参考配置如下：

{
    "configurations": [
        {
            "name": "Mac x64",
            "includePath": ["${default}"],
            "defines": [],
            "compilerPath": "/usr/bin/clang++",
            "cStandard": "c17",
            "cppStandard": "c++17",
            "intelliSenseMode": "macos-clang-x64",
            "configurationProvider": "ms-vscode.cmake-tools"
        }
    ],
    "version": 4
}

注意：配置configurationProvider后，IntelliSense会自动从CMake构建配置中拉取所有头文件路径，不需要手动硬编码vcpkg的include目录，手动写路径很容易因为层级错误、架构不匹配出现识别问题

• 第三步：校验vcpkg安装的OpenCV架构匹配性，在终端执行以下命令查看已安装的OpenCV包：
  vcpkg list opencv
  如果输出中安装的triplet不是x64-osx，执行命令重新安装对应架构版本：
  vcpkg install opencv:x64-osx

• 第四步：清理CMake缓存重新配置，删除项目根目录下的build文件夹，在VSCode命令面板执行CMake: Delete Cache and Reconfigure，等待配置完成后重新打开源码文件即可识别头文件。

• 额外优化：当前使用的VSCode 1.49.2版本发布时间过早，和最新版C/C++扩展、CMake Tools扩展存在兼容问题，升级到VSCode最新稳定版后重启，可以解决绝大多数偶发的IntelliSense识别异常。

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