# 项目

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

无论您在 CLion 中做什么，都是在  项目 的上下文中进行的。 项目是表示完整软件解决方案的组织单元。 它是代码辅助、大规模重构、代码风格一致性等功能的基础。

CLion 支持以下项目格式：CMake、Makefile、JSON 编译数据库、Gradle、Meson 和 Zephyr West。 欲了解更多信息，请参阅 [项目格式](project-models.html)。

## 项目文件

CLion 中的项目以  基于目录的格式 表示。 项目目录包含  `.idea` 目录（在 [项目工具窗口](project-tool-window.html)的项目视图中不可见），其中包含以下文件：

* `.iml` 文件描述了项目结构。

* `workspace.xml` 文件包含您的工作区首选项。

* 若干 `xml` 文件。 每个 `xml` 文件负责其自己的设置集，可以通过其名称识别： `projectCodeStyle.xml` 、 `encodings.xml` 、 `vcs.xml` 等。 例如，添加新的运行/调试配置和更改编码将影响两个不同的 `xml` 文件。 这有助于避免当项目设置存储在版本控制系统中并由不同团队成员修改时的合并冲突。

`.idea` 目录中的所有设置文件都应 [置于版本控制](enabling-version-control.html#associate_directory_with_VCS)之下，除了  `workspace.xml` ，它存储您的本地首选项。  `workspace.xml` 文件应 [被 VCS 标记为忽略](set-up-a-git-repository.html#ignore-files)。

## 项目根目录

CLion 中的任何项目都应封装在称为项目根目录的项目目录中。 它包含所有项目文件和子目录，包括配置、数据、源代码以及与项目相关的其他文件。

项目根目录包含一个或多个项目描述文件，这些文件也是构建系统的输入：CMake 的 [CMakeLists.txt](cmakelists-txt-file.html)， [编译数据库](compilation-database.html)的  `compile_commands.json` ， [Makefiles](makefiles-support.html)的  `Makefile` ，以及 [Gradle](gradle-support.html)的  `构建.gradle` 。

当您打开一个项目时，CLion 会将顶级配置文件的位置视为项目根目录。 此外，对于 [CMake](quick-cmake-tutorial.html)，当您 [创建](creating-new-project-from-scratch.html#create-prj)一个新的 CMake 项目时，CLion 会将  `CMakeLists.txt` 文件放置在根目录下。

如果您需要更改项目根目录，请按照 [此说明](change-project-root-directory.html#change-root-procedure)操作。

## See also

### 外部链接

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

### 流程

[快速 CMake 教程](quick-cmake-tutorial.html) [路径变量](absolute-path-variables.html)

### 参考

[项目工具窗口](project-tool-window.html)

