vcpkg是Windows下VSCode集成C++依赖库最省心方案，因其自动处理头文件、链接库及调试符号，且与MSVC和CMake深度协同；需运行vcpkg integrate install并手动在.settings.json中配置绝对路径的CMAKE_TOOLCHAIN_FILE，同时确保三元组（如x64-windows）与编译器Kit严格匹配。
VSCode 里集成 C++ 依赖库，vcpkg 是目前 Windows 下最省心、兼容性最好、和 CMake 配合最顺的方案——尤其当你用 MSVC 编译器时，它能自动处理头文件路径、链接库、甚至调试符号，基本不用手动改 CMAKE_PREFIX_PATH 或 include_directories。
为什么不是 Conan 或手动编译
Conan 配置复杂，conanfile.py 写错一行就卡在 conan install；手动下载 OpenCV/Tesseract 源码再 cmake + make，容易漏掉 Leptonica、zlib 等隐式依赖，而且 find_package(OpenCV) 经常报 NOTFOUND。而 vcpkg install opencv:x64-windows 一条命令连依赖树都帮你拉齐了，装完就能 find_package 成功。
vcpkg integrate install 必须运行，但别信它“全局生效”
这条命令只是把 vcpkg.cmake 工具链路径写进用户级 CMake 配置（Windows 上是 %LOCALAPPDATA%\CMakeSettings.json），VSCode 的 CMake Tools 插件不一定读它。实际项目中更可靠的做法是：在项目根目录的 .vscode/settings.json 里硬编码工具链路径：
{
"cmake.configureArgs": [
"-DCMAKE_TOOLCHAIN_FILE=<code>D:/dev/vcpkg/scripts/buildsystems/vcpkg.cmake</code>"
]
}
注意： 标签内必须是绝对路径，且斜杠用正斜杠 /（即使在 Windows 上），否则 CMake 配置会静默失败。
find_package 失败？先检查三元组是否匹配
常见错误现象：find_package(OpenCV REQUIRED) 报 Could NOT find OpenCV，但 vcpkg list 明明显示已安装。问题大概率出在三元组不一致：
- 你用的是 MSVC x64 编译器，但装库时执行的是
vcpkg install opencv:x86-windows（32 位） - VSCode 底部状态栏选的 Kit 是
Visual Studio Community 2022 Release - amd64，但 CMake 配置时没传-DVCPKG_TARGET_TRIPLET=x64-windows -
CMakeLists.txt里漏了set(CMAKE_SYSTEM_NAME Windows)，导致 vcpkg 工具链无法识别平台
验证方法：在终端进项目 build 目录，手动跑一次 cmake -DCMAKE_TOOLCHAIN_FILE=... -DVCPKG_TARGET_TRIPLET=x64-windows ..，看是否成功。如果手动可以，说明 VSCode 的 Kit 或 settings.json 没对齐。
装完库后 #include 还标红？
这是 C/C++ 扩展的 IntelliSense 没刷新路径，不是编译问题。解决方式只有两个：
- 重启 VSCode（最稳）
- 或按
Ctrl+Shift+P→ 输入C/C++: Reset IntelliSense Database→ 回车
别去改 c_cpp_properties.json 里的 includePath，vcpkg 工具链已经把路径注入 CMake，手动加反而可能冲突。另外，确保 C/C++ 扩展版本 ≥ 1.19.0，老版本对 vcpkg 的 CONFIG 模式支持不全。
真正麻烦的点不在安装，而在「三元组」和「工具链路径」这两个地方——它们不出错时一切丝滑，一出错就是无声失败，连错误提示都不给。建议第一次配通后，把 vcpkg root 路径和默认三元组记死，后续所有项目复用同一套配置，比每次重试强。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
