CMake 本身无图形界面,需通过支持它的 IDE(如 CLion、VS2022)或命令行加载 CMakeLists.txt 生成构建文件;CLion 必须直接打开 CMakeLists.txt 文件并选“Open as Project”,VS2022 需确保无 .vcxproj/.sln 文件且通过“File → Open → Cmake”加载;命令行推荐用 cmake -S . -B build 生成构建产物。

CMake 本身不提供图形界面,也没有“打开项目”这个操作 —— 它只是一个构建系统生成器,不是 IDE。 你真正要做的,是用支持 CMake 的 IDE(比如 CLion、Qt Creator、VS2022)或命令行工具加载 CMakeLists.txt 并生成构建文件。
CLion 打开已有 CMake 项目时,必须选对文件
CLion 不识别任意目录,它只认 CMakeLists.txt 文件作为入口。常见错误是直接打开源码根目录,结果提示“no CMakeLists.txt found”。
- 启动 CLion 后,点击 Open(不是 New Project),然后定位到包含
CMakeLists.txt的目录(不是子目录,也不是上层目录) - 选中
CMakeLists.txt文件本身,点击 OK → 弹窗选 Open as Project - 如果项目已有构建目录(如
build/),CLion 默认会清空它并重新 configure;想复用旧构建,需在弹出的配置页里手动指定Build directory路径
VS2022 打开 CMake 项目必须通过 CMakeLists.txt,且不能有同名 .vcxproj
VS2022 原生支持 CMake,但前提是项目目录里没有 .vcxproj 或 .sln 文件。一旦存在,VS 会优先按传统 MSBuild 方式加载,CMakeLists.txt 就被忽略。
- 确保目标目录下只有
CMakeLists.txt和源码,删掉残留的*.vcxproj、*.sln、build/、CMakeCache.txt - 菜单栏选择 File → Open → CMake(不是 Open Folder),然后选中
CMakeLists.txt - 首次加载后,VS 底部状态栏会显示 “CMake is configuring...”,完成后才能看到 target 列表和调试按钮
命令行下“打开”=运行 cmake 命令生成构建产物
所谓“打开”,本质是让 CMake 解析 CMakeLists.txt 并产出 Makefile/Ninja/Visual Studio solution 等中间文件。这步失败,后续所有 IDE 加载都会卡住。
- 终端 cd 到含
CMakeLists.txt的目录,执行:cmake -S . -B build(推荐,显式指定源码和构建目录) - 不要用
cmake .—— 它把构建文件全塞进源码目录,污染 git、IDE 缓存,且 Windows 下容易因权限问题失败 - 如果报错 “Could not find compiler set in environment variable CC”,说明没装编译器或没加到 PATH;Ubuntu 需先
sudo apt install build-essential,Windows 需装 Visual Studio Build Tools 或 MinGW
最容易被忽略的是:CMake 不保存项目状态,每次 IDE 启动都重新读取 CMakeLists.txt 并触发 configure。哪怕只是改了一行 add_executable(),下次打开 IDE 时都会重新跑一遍 configure 步骤 —— 这不是 bug,是设计使然。


















