Visual Studio 2019 16.10+ 和 VS 2022 原生支持直接打开含 CMakeLists.txt 的文件夹，无需新建项目；但需确保根目录有 CMakeLists.txt、cmake.exe 路径正确配置、并安装“C++ CMake 工具”工作负载，否则 CMake 集成将静默失败。
直接用 Visual Studio 打开含 CMakeLists.txt 的文件夹就行，不用手动新建项目或转换工程——VS 2019 16.10+ 和 VS 2022 原生支持 CMake 项目，但默认不启用预设（CMakePresets.json），且编译器选择、配置路径、缓存生成逻辑和传统 MSBuild 项目完全不同。
打开文件夹后 CMake 没反应？检查这三件事
VS 不会自动识别任意层级的 CMakeLists.txt。常见静默失败原因：
- 根目录下没有
CMakeLists.txt：如果它在src/或build/子目录里，VS 默认不扫描——从 VS 2022 17.1 起会弹提示问“是否启用 CMake 集成”，选“是”才生效；旧版本需手动在“工具 > 选项 > CMake > 常规”里勾选“启用 CMake 预设支持”并重启 -
cmake.exe不在系统 PATH 或 VS 未检测到：VS 默认调用cmake.exe进行配置，不是调用 MSBuild。若报错CMake executable not found，需在“工具 > 选项 > CMake > 常规”中指定完整路径，例如C:\Program Files\CMake\bin\cmake.exe - 没装对应工具集：“使用 C++ 的桌面开发”工作负载必须包含“用于 Windows 的 C++ CMake 工具”，否则即使有
cmake.exe，VS 也无法提供 IntelliSense 或调试支持
为什么选了 Visual Studio 2022 生成器却编译失败？
VS 的 CMake 集成不使用“生成器（Generator）”概念，而是靠内部驱动——你看到的“Visual Studio 17 2022”只是历史遗留显示，实际不生效。真正起作用的是：
-
活动配置 + 平台：右下角状态栏显示的
Win32/x64和Debug/Release直接决定CMAKE_BUILD_TYPE和目标架构，不是靠cmake -G设置 -
编译器绑定：VS 自动把
CMAKE_CXX_COMPILER绑定到当前选中的工具集（如MSVC v143），你不能在CMakeLists.txt里硬写set(CMAKE_CXX_COMPILER "cl.exe")，否则会冲突 -
缓存位置固定：VS 在项目根目录下建
out/build/<config>文件夹放CMakeCache.txt和构建产物，删错目录会导致重新 Configure 失败
CMakePresets.json 怎么让 VS 正确读取？
VS 2022 17.4+ 支持 CMakePresets.json，但它和命令行行为不一致：
- VS 不执行
cmake --preset命令，而是直接解析 JSON 内容——所以"version": 5必须匹配你 VS 的支持版本（查 官方文档确认） -
"configurePreset"中的"cacheVariables"可覆盖CMakeLists.txt的set()，但"binaryDir"必须是相对路径（如"out/build/${presetName}"），绝对路径会被忽略 - VS 默认只读
CMakePresets.json，不读CMakeUserPresets.json——除非你在“工具 > 选项 > CMake > 常规”里勾选“启用用户预设支持” - 改完
CMakePresets.json后，必须点击“CMake > 重新扫描”或关闭再重开文件夹，VS 才会重新加载，不会热更新
最易被忽略的点：VS 的 CMake 集成本质是“IDE 驱动 CMake”，不是“CMake 驱动 IDE”。所有构建逻辑仍由 cmake.exe 执行，VS 只负责调用、解析输出、映射符号到源码——这意味着你不能指望它像传统 .vcxproj 那样自由增删源文件或修改链接器输入项；所有变更必须回到 CMakeLists.txt 或预设里调整。
