# 内容根

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

IntelliJ IDEA 中的内容是一组包含您的源代码、构建脚本、测试和文档的文件。 这些文件通常按层次结构组织。 顶级文件夹称为  content root 。

模块通常只有一个内容根。 您可以添加更多内容根目录。 例如，这在您的代码存储在计算机的不同位置时可能会很有用。

同时，模块可以在没有内容根的情况下存在。 在这种情况下，您可以将它们用作其他模块的依赖项集合。

## 配置文件夹结构

内容根目录中的文件夹可以根据其存储的内容分配到不同的类别。

Procedure: 在 Project 工具窗口中配置文件夹

1. 在   项目  工具窗口 `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))中，右键点击一个文件夹并选择   标记目录为  。

2. 请选择所需的 [类别](#folder-categories)。 这样您也可以将类别分配到子文件夹。

![将文件标记为纯文本文件](https://resources.jetbrains.com/help/img/idea/2026.3/ij_exclude_folder.png)

要恢复文件夹之前的类别，请再次右键点击该文件夹，选择   标记目录为  ，然后选择   取消标记为<文件夹类别>  。 对于排除的文件夹，请选择   取消排除  。

Procedure: 在项目结构中配置文件夹

如果您想配置多个文件夹，请使用这些步骤。

1. 在主菜单中，前往  `文件 | 项目结构` 或按 `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS))以打开   项目结构  对话框。

2. 在左侧列表中，选择   模块  。

在对话框的中间部分，选择您要配置文件夹结构的模块。 然后确保您在   源  选项卡上。

3. 选择要分配 [类目](#folder-categories)的文件夹，然后点击模块树上方工具栏中的相应按钮。

![在项目结构中配置文件夹](https://resources.jetbrains.com/help/img/idea/2026.3/configure_folders_in_structure.png)

### 文件夹类别

* ![源代码根目录](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.nodes.sourceRoot.svg) 源 此文件夹包含应编译的生产代码。 > **Note:** > IntelliJ IDEA 会编译 Sources 文件夹中的代码。 不要将配置文件（ `.idea` 文件夹或其内容与 `.iml` 文件）放入此文件夹。 有关不同类型设置的更多信息，请参阅 [项目、模块和全局设置](working-with-projects.html#settings-types)。

* ![生成的源根目录](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.nodes.generatedSource.svg) 生成的源文件 IDE 认为 Generated Sources 文件夹中的文件是自动生成的，而不是手动编写的，并且可以重新生成。

* ![测试源根目录](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.nodes.testRoot.svg) 测试源 这些文件夹将测试相关代码与生产代码分开存放。 源代码和测试源代码的编译结果通常放置在不同的文件夹中。

* ![生成的测试源根目录](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.nodes.generatedTestRoot.svg) 生成的测试源 IDE 认为此文件夹中的文件是自动生成的，而不是手动编写的，并且可以重新生成。

* ![资源根目录](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.nodes.resourcesRoot.svg) 资源 （仅限 Java）应用程序中使用的资源文件：图像、配置 XML 和属性文件等。 在构建过程中，资源文件默认会原样复制到输出文件夹。 您可以 [更改资源文件的输出路径](#specify_output_path)。 与源类似，您可以指定您的资源是生成的。 您还可以指定资源应复制到输出文件夹内的哪个文件夹。

* ![测试资源根目录](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.nodes.testResourcesRoot.svg) 测试资源 这些文件夹用于与您的测试源关联的资源文件。

* ![已排除](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.nodes.excludeRoot.svg) 已排除 在排除的文件夹中的文件将被代码补全、导航和检查忽略。 这就是为什么当您排除一个您目前不需要的文件夹时，您可以提升 IDE 性能。 通常，编译输出文件夹会被标记为排除。 除了排除整个文件夹，您还可以 [排除指定文件](#exclude-files)。 > **Note:** > 将文件或文件夹标记为排除项不会影响部署。 要了解更多关于部署排除的信息，请参阅 [排除文件和文件夹的上传和下载](excluding-files-and-folders-from-deployment.html)。

## 添加新的内容根目录

Procedure:

1. 在主菜单中，转到  `文件 | 项目结构` ，或按 `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS)) 并点击  `项目设置 | 模块` 。

2. 选择所需的模块，然后打开对话框右侧部分的   源  选项卡。

3. 点击   添加内容根目录   并指定您要添加为新内容根目录的文件夹。

![添加新的内容根目录](https://resources.jetbrains.com/help/img/idea/2026.3/add-new-content-root.png)

要移除内容根，请点击   移除内容条目  按钮( ![删除内容条目按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.closeSmall.svg))。 IntelliJ IDEA 将选定的根标记为常规文件夹。 文件夹本身及其内容不会被删除。

## 排除文件和文件夹

### 排除文件

> **Tip:**
> Java 文件和二进制文件无法排除。

如果您不需要特定文件，但又不想完全删除它们，您可以暂时将这些文件从项目中排除。 排除的文件不会被代码补全、导航和检查所处理。

要排除文件，您需要将其标记为纯文本文件。 您可以随时将排除的文件恢复到原始状态。

Procedure:

1. 转到   项目   工具窗口（ `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))）。

2. 右键点击文件并选择  `重写文件类型 | 纯文本` 。

纯文本文件标有 ![由水平线表示的纯文本图标。](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.fileTypes.text.svg)图标。

![将文件标记为纯文本文件](https://resources.jetbrains.com/help/img/idea/2026.3/ij_exclude_file.png)

要恢复更改，请右键点击文件，然后选择   还原文件类型重写  。 从菜单中。

### 排除文件夹

Procedure:

1. 转到   项目   工具窗口（ `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))）。

2. 右键点击文件夹并选择  `将目录标记为 | 已排除` 。

排除的文件夹会被标记为 ![由橙色文件夹表示的排除根图标。](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.nodes.excludeRoot.svg)图标。

![将文件标记为纯文本文件](https://resources.jetbrains.com/help/img/idea/2026.3/ij_exclude_folder.png)

要恢复文件夹之前的类别，请再次右键点击该文件夹，选择   标记目录为  ，然后选择   取消排除  。

### 按名称模式排除文件和文件夹

有时，一个接一个地排除文件或文件夹并不方便。 例如，如果您的源代码文件和自动生成的文件（例如编译器生成的文件）放置在同一目录中，并且您只想排除生成的文件，这可能会很不方便。 在这种情况下，您可以为特定内容根配置一个或多个名称模式。

如果选定内容根目录中的文件夹或文件名符合某个模式，它将被标记为排除。 选定内容根目录之外的对象不会受到影响。

排除文件夹中的所有文件也将被排除。

Procedure:

1. 在主菜单中，转到  `文件 | 项目结构` 或按 `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS))

2. 请点击   模块  下的   项目设置  部分，然后选择一个模块。

如果此模块中有多个内容根目录，请选择您要从中排除文件或文件夹的那个。

3. 在对话框底部的   排除文件  字段中输入一个模式。 例如，输入  `*.aj`  排除 AspectJ 文件。

您可以配置多个模式，并使用分号符号（  `;` ）将它们分开。

模式仅应用于文件和目录名称。 无法用于匹配特定路径或目录（例如，不支持  `vendor/bin/*` ）。 如果目录名称匹配，则将排除其所有内容。

> **Note:**
> 将文件或文件夹标记为排除项不会影响部署。 要了解更多关于部署排除的信息，请参阅 [排除文件和文件夹的上传和下载](excluding-files-and-folders-from-deployment.html)。

## 为 Java 源分配包前缀

在 Java 中，您可以为文件夹分配包前缀，而不是手动配置文件夹结构。 可以将包前缀分配给源文件夹、生成的源文件夹、测试源文件夹和生成的测试源文件夹。

Procedure:

1. 在主菜单中，转到  `文件 | 项目结构` ，或按 `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS)) 并点击   模块  。

2. 选择所需的模块并打开   源   选项卡。

3. 在右侧窗格中，点击 ![编辑属性按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.edit.svg) 旁边的   源文件夹   或   测试源文件夹  。

4. 请指定包前缀，然后点击   OK  。

![为源文件夹分配一个包前缀](https://resources.jetbrains.com/help/img/idea/2026.3/package_prefix.png)

## 更改资源的输出路径

在构建项目时，资源会默认复制到编译输出文件夹中。 您可以指定输出文件夹中的不同目录来放置资源。

> **Note:**
> 此信息适用于使用原生 IntelliJ IDEA 构建器构建的项目。 如果您正在使用构建工具，例如 [Maven](maven-support.html) 或 [Gradle](gradle.html)，请使用构建文件进行所有更改。

Procedure:

1. 在主菜单中，转到  `文件 | 项目结构` ，或按 `Ctrl+Alt+Shift+S` (Windows), `⌘ ;` (macOS), `⌘ ;` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ Comma` (macOS System Shortcuts), `Ctrl+Alt+Shift+S` (XWin), `Ctrl+Alt+Shift+S` (GNOME), `Ctrl+Alt+Shift+S` (KDE), `Ctrl+Alt+Shift+S` (Emacs), `Ctrl+Alt+Shift+S` (Sublime Text), `⌘ ;` (Sublime Text (macOS)), `Ctrl+Alt+Shift+S` (Visual Studio), `⌘ ;` (Visual Studio (macOS)), `Ctrl+Alt+Shift+S` (NetBeans), `Ctrl+Alt+Shift+S` (Eclipse), `⌘ ;` (Eclipse (macOS)) 并点击   模块  。

2. 选择所需的模块并打开   源   选项卡。

3. 在右侧窗格中，在   资源文件夹   或   测试资源文件夹   下，点击所需文件夹（文件夹路径）右侧的 ![编辑属性按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.edit.svg)。

4. 指定相对于输出文件夹根目录的路径，然后点击   OK  。

![更改资源的输出路径](https://resources.jetbrains.com/help/img/idea/2026.3/resource-properties-project-structure-image.png)

