# 管理 CMake 项目文件

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

Procedure: 添加新文件

1. 在项目树中，右键点击您想要添加文件的文件夹，然后从上下文菜单中选择   新建  。 选择所需的文件类型：

![添加源文件](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmaketutorial_addsourcefile.png)

2. 为新文件指定名称、类型和 [附加选项](creating-files-from-templates.html)。

![将文件添加到现有目标](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_tutorial_addfiletotarget.png)

3. 对于   C++ 类  、   C/C++ 源文件  、   C/C++ 头文件  和   C++ 模块接口单元  模板，CLion 将提示您将新文件添加到 CMake 目标。 您可以选择现有目标或创建新目标。

要添加新的 CMake 目标：

1.

点击   添加新目标  链接：

![将文件添加到新目标](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_newfile_addtotargets.png)

2.  指定目标类型、名称和位置。 然后点击   Add  ：

![添加新的可执行目标](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmaketutorial_newexetarget.png)

3.

新创建的目标将出现在列表中。

![新目标已添加到目标列表](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmaketutorial_newtarget_added.png)

Procedure: 管理包含的文件

* 当您将位于   在项目根目录下  的头文件或源文件包含到任何项目文件中时，CLion 也会将其视为项目文件。 无需在  `CMakeLists.txt` 中手动列出此类包含项。

> **Note:**
> 这不适用于位于  项目根目录之外 的标准或第三方库。

Procedure: 将现有文件添加到 CMake 目标

要添加未包含在任何项目文件或 CMake 目标中的文件，请执行以下操作之一：

* 点击编辑器右上角的   添加到 CMake 项目  ：

![将文件添加到 CMake 项目](https://resources.jetbrains.com/help/img/idea/2026.3/cl_add_to_cmake_project.png)

您可以选择现有目标或 [创建新目标](#add-cmake-targets)。

* 在   项目  工具窗口中选择一个或多个文件，然后从上下文菜单中选择   将 <filename> 添加到 CMake 项目  ：

![从上下文菜单将文件添加到 CMake 项目](https://resources.jetbrains.com/help/img/idea/2026.3/cl_add_to_cmake_project_context_menu.png)

* 您还可以手动将文件添加到 CMake 项目。

如果文件位于 [项目根目录](project.html#ProjectRootDirectory)下，请使用  `add_executable()` 或  `add_library()` 命令将其添加到目标。

* 如果包含非项目源的目录位于项目根目录下，您还可以将其 [标记](controlling-source-library-and-exclude-directories.html)为库：在项目视图中右键点击并从上下文菜单中选择  `将目录标记为 | 库文件` 。

要使用位于项目根目录之外的库文件，您需要指定头文件搜索路径，以便 CLion 能够索引目录并为  `#include` 语句提供补全和导航：

```CMAKE
include_directories(${MY_EXTERNAL_SOURCE__DIR})

```

其中  `MY_EXTERNAL_SOURCE__DIR` 是所需的外部路径。

> **Note:**
> 在 Windows 上，请确保将路径中的反斜杠替换为正斜杠  `/` ，例如：  `include_directories(C:/Users/jetbrains/CLionProjects/clang/include)`

有关更多信息，请参阅 [快速 CMake 教程：添加包含目录](quick-cmake-tutorial.html#inc-dirs)。

> **Tip:**
> 执行这些操作中的任何一个后，CLion 将提示您 [重新加载](reloading-project.html)项目（如果禁用了自动重新加载）。

## See also

### 操作指南

[快速 CMake 教程](quick-cmake-tutorial.html) [Load/Reload CMake](reloading-project.html)

