# 创建/打开 CMake 项目

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/clion/llms.txt).

Procedure: 从头创建一个 CMake 项目

1. 在欢迎屏幕上点击   新项目   或从主菜单中选择  `文件 | 新建项目` 。

2. 在左侧窗格中选择   C++ 可执行文件  。 设置项目名称和语言标准。

![创建一个新的 CMake 项目](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmaketutorial_create_prj.png)

3. 点击   创建  。

4. CLion 生成一个包含单个源文件  `main.cpp`  和根 [CMakeLists.txt](cmakelists-txt-file.html) 的存根项目，其中包含以下命令：

![在一个存根 CMake 项目中使用 CMakeLists.txt](https://resources.jetbrains.com/help/img/idea/2026.3/cl_simple_cmakeprj.png)

|  命令  |  描述  |
| --- | --- |
|   `cmake_minimum_required(VERSION 3.31)`   |  [指定](https://cmake.org/cmake/help/latest/command/cmake_minimum_required.html) CMake 的最低要求版本。 它被设置为 CLion 中捆绑的 CMake 版本（始终是可用的最新版本之一）。  |
|   `project(cmake_testapp)`   |  根据我们在项目创建期间提供的内容定义项目名称。  |
|   `set(CMAKE_CXX_STANDARD 20)`   |     [设置](https://cmake.org/cmake/help/latest/command/set.html)  CMAKE_CXX_STANDARD  变量的值为  20 ，这是我们在创建项目时选择的。     |
|   `add_executable(cmake_testapp main.cpp)`   |  [添加](https://cmake.org/cmake/help/latest/command/add_executable.html)  cmake_testapp  可执行目标，该目标将从  `main.cpp`  构建。  |

> **Tip:**
> 您可以在 [C/C++ 和 CMake 文件的文件模板](using-file-and-code-templates.html#cpp-templates) 中调整模板代码。

5. CMake   工具窗口显示项目加载的进度和状态。 您始终可以从  `视图 | 工具窗口 | CMake`  访问它，或在底部导航栏中切换到它。

![CMake 工具窗口](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmaketutorial_toolwindow.png)

> **Tip:**
> 如果加载失败，CMake 工具窗口会自动打开。

Procedure: 从源代码创建一个 CMake 项目

在 CLion 中，您可以打开一个非 CMake 项目并将其结构转换为 CMake。

1. 在欢迎屏幕上点击   打开   或从主菜单中选择  `文件 | 打开` 。

2. 选择项目根文件夹并点击   打开  ：

![打开一个非 CMake 项目的文件夹](https://resources.jetbrains.com/help/img/idea/2026.3/cl_non_cmake_open_project.png)

3. 在编辑器中打开任何源文件。 您将在状态栏中看到 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.inspectionsWarningIcon.svg) 的  `项目状态小部件`  通知：

![项目未配置通知](https://resources.jetbrains.com/help/img/idea/2026.3/cl_non_cmake_is_not_configured.png)

点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.inspectionsWarningIcon.svg)，选择   配置 CMake 项目  ，然后选择   创建 CMakeLists.txt  ：

![创建 CMakeLists.txt](https://resources.jetbrains.com/help/img/idea/2026.3/cl_non_cmake_configure.png)

> **Tip:**
> 创建 CMakeLists.txt   操作仅在项目根目录下没有  `CMakeLists.txt`  时出现，而不考虑子文件夹。
>
>
>
> 如果根目录下有一个  `CMakeLists.txt`  文件，则唯一可用的操作是   选择 CMakeLists.txt  。

> **Tip:**
> 您还可以使用  `c_cpp_properties.json`  帮助 CLion 查找在  `.cpp`  文件中提到并应包含在项目中的头文件。
>
>
>
> 如果没有加载项目模型，并且头文件位于非自动包含的路径中，您可以使用  `c_cpp_properties.json`  将它们包含进来。 然后，语言引擎会在代码分析和代码洞察期间将它们考虑在内。
>
>
>
> 在 [c_cpp_properties.json 参考](https://code.visualstudio.com/docs/cpp/customize-cpp-settings) 中了解更多信息。

4. 在打开的对话框中，指定以下内容：

* 选择项目文件 . 选择要作为项目文件导入的文件。 使用子目录复选框导入其全部内容，或清除复选框以选择性地导入内容。

* 用户包含目录 . 选择要包含在项目中的目录，并在 CMake [include_directories](https://cmake.org/cmake/help/latest/command/include_directories.html) 命令中指定。 在 选择项目文件 中未选择的目录不会显示在 用户包含目录 列表中——请先选择它们，然后可用的包含目录将出现在列表中。 ![创建 CMakeLists.txt 对话框](https://resources.jetbrains.com/help/img/idea/2026.3/cl_non_cmake_create_cmk_list.png)

5. 点击   确定   后，CLion 会根据您的选择生成一个  `CMakeLists.txt`  文件并加载 CMake 项目结构。

![CMakeLists.txt 已生成](https://resources.jetbrains.com/help/img/idea/2026.3/cl_non_cmake_cmk_list_include.png)

Procedure: 打开一个 CMake 项目

> **Tip:**
> 如果您正在使用 monorepo，请参阅 [此说明](#monorepos)。

要在 CLion 中打开现有的 CMake 项目，请执行以下操作之一：

* 选择   文件 | 打开   并定位到项目目录。 此目录应包含一个  `CMakeLists.txt`  文件。

* 选择   文件 | 打开   并将 CLion 指向顶层  `CMakeLists.txt`  文件（或定位到  `CMakeCache.txt`  文件）。

然后点击   作为项目打开  ：

![将 CMakeLists.txt 作为项目打开](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_openasproject.png)

首次打开项目时，CLion 会显示 [CMake 配置文件](cmake-profile.html) 对话框，其中包含初始配置。 您可以编辑配置文件或继续使用默认设置。

![默认 CMake 配置文件设置](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_default_profile.png)

要禁用此初始配置文件设置，请转到  `设置 | 高级设置`  并清除相应的复选框：

![初始 CMake 配置文件设置](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_advancedsettings_initialprofile.png)

> **Note:**
> 您可以设置一个 [CMake 配置文件](cmake-profile.html) 以默认用于所有新项目（  `文件 | 新项目设置 | 构建、执行、部署 | CMake` ）。

Procedure: 使用 monorepo

Monorepo 是一种将多个项目组合在一起的存储库，通常没有顶层 CMake 脚本。 以下说明描述了如何在 CLion 中使用 [LLVM 项目](https://github.com/llvm/llvm-project) 作为示例来处理 monorepo。

1. 调用  `文件 | 打开`  并将 CLion 指向所需子目录中的  `CMakeLists.txt` 。 对于 LLVM 的情况，选择  `llvm-project/llvm/CMakeLists.txt` 。

在打开的对话框中，点击   作为项目打开  。

2. 在   打开项目向导   中，在   CMake 选项   字段中添加您想要构建的子项目。

例如，要添加   clang   和   clang-tools-extra  ，请指定

```
-DLLVM_ENABLE_PROJECTS="clang;clang-tools-extra"
```

![LLVM 子项目的编译器标志](https://resources.jetbrains.com/help/img/idea/2026.3/cl_llvmmonorepo_flags.png)

此时，项目加载应成功完成。

3. 要在项目树中查看整个存储库，请更改项目根目录：从主菜单调用  `工具 | CMake | 更改项目根目录`  并选择顶层存储库文件夹，  `llvm-project` 。

4. 我们还建议您 [构建](build-actions.html) 项目。 这样，解析将适用于整个代码库，包括在构建时生成的部分。

## See also

### 概念

[项目](project.html)

### 流程

[快速 CMake 教程](quick-cmake-tutorial.html)

### 操作指南

[文件模板](using-file-and-code-templates.html)

### 外部链接

[JetBrains CLion Blog](http://blog.jetbrains.com/clion/)

