llms.txt: machine-readable documentation index. Markdown version of this page is also available.

IntelliJ IDEA 2026.3 Help

文件范围与文件颜色

一个 作用域 范围图标 是 project 中具有名称的文件、软件包和文件夹设置。省略号结束。 作用域可帮助在不同的 IDE 视图中 直观区分 project 项,并限制某些操作的范围。

借助作用域,可以按逻辑组织文件。 例如,可以将测试源放入测试作用域,并将生产代码保留在生产作用域中。 这样可以更轻松地处理大型projects。 仅对测试运行检查比对整个代码库运行检查更快。

IntelliJ IDEA 随附一项 预定义作用域设置,但也可以创建自己的作用域。 自定义作用域可以包含任何文件设置,例如仅包含所负责的 project 部分。

在 IntelliJ IDEA 中,作用域用于 各种功能 :代码检查、一些重构操作、搜索、版权设置、各种代码分析功能等。

在 IntelliJ IDEA 中,有两种类型的作用域:本地和共享。

  • 本地作用域 存储在 IDE 配置目录中,因此它们不会通过 VCS 共享,也不会对您的团队其他成员可用。

  • 共享作用域 被添加到版本控制系统 (VCS),以便在 project 上工作的人员可以使用相同的作用域。 这些作用域与 project 一起存储在 scopes 文件夹下 .idea 。 每个 scope 都会保存为一个文件,并带有 .xml 扩展名(例如: My项目/.idea/scopes/shared-scope.xml )。

如果您的 project 受 版本控制 ,那么使用共享作用域是有意义的。 如果不使用 VCS,本地作用域就足以满足需求。

定义新范围

在 IntelliJ IDEA 中,有一组 预定义作用域 ,但您也可以定义自己的作用域。

  1. 按 Ctrl+Alt+S 打开设置,然后选择 外观 & 行为 | 作用域。

  2. 点击 添加作用域 按钮(添加范围按钮 ),然后选择要定义的作用域类型: 本地 或 共享。

    可以稍后使用 通过 VCS 共享 复选框更改所选作用域的状态(本地或共享)。

    创建新作用域:选择共享作用域还是本地作用域
  3. 在打开的对话框中,为新作用域指定名称,然后点击 OK。

  4. 将文件添加到新作用域。 在 project 树中选择必要的项目,然后点击树右侧的一个选项:

    • 包含 :包含所选项目。 如果您包含一个文件夹,此操作只会添加位于此文件夹内的文件。 所有嵌套的子文件夹及其内容将不会被包含。

    • 递归包含 :包含所选文件夹以及嵌套的子文件夹及其内容。

    • 排除 :从作用域中排除所选项。 如果您排除了一个文件夹,此操作仅会删除位于该文件夹内的文件。 所有嵌套子文件夹及其内容都将保留在作用域中。

    • 递归排除 :排除所选文件夹及其嵌套子文件夹及其内容。

    添加了文件和文件夹的新作用域

    向作用域添加文件时,IntelliJ IDEA 会创建一个表达式并将其显示在 模式 字段中。

    除了使用按钮,您还可以在 模式 字段中手动输入模式,使用 范围语言语法参考。

  5. 应用更改并关闭对话框。

为所选作用域显示的文件和文件夹会以不同颜色显示,帮助了解包含和未包含的内容:

  • 绿色样本 作用域中包含的文件和文件夹。

  • 深蓝色样本 包含已排除和已包含文件及文件夹的文件夹。

  • 黑色样本 从所选作用域中排除的文件和文件夹。

创建自定义范围后,您可以在 项目 工具窗口和允许您限制要应用操作的文件数量的 所有对话框中找到它。

项目工具窗口中显示的新范围

预定义作用域

IntelliJ IDEA 提供了一组预定义的作用域。 IDE 会根据这些文件的信息自动将其添加到这些作用域中。 请注意,这些范围无法修改。

预定义范围列表

  • 项目文件 :包括 project 内容根目录中的所有文件。 更多信息请参阅 内容根。 库和 SDK 不包含在此范围内。

  • 问题 :包含 project 内容根目录中的语法错误文件。

  • 所有更改的文件 :包括所有最近更改的文件。

  • 临时文件和控制台 :包括位于 项目 工具窗口中的 临时文件和控制台 目录中的所有文件。

  • 最近查看的文件 和 最近更改的文件 :包括您在编辑器中打开或修改的最后 50 个文件。 要更改最近文件的数量,请按 Ctrl+Alt+S 打开设置并选择 高级设置 ,搜索 最近文件的最大数量 字段,然后指定首选的数量。

  • 项目和库 :包括 project 内容根目录中的所有文件以及所有模块依赖项(库和 SDK)。

  • 被 Git 跟踪的项目文件 :包含 project 内容根中在 Git 下受版本控制的所有文件。

  • 排除 Git 忽略的项目文件 :包含 project 内容根中的所有文件,包括受 Git 版本控制的文件和未受版本控制的文件,但不包括 .gitignore 中指定的文件。

  • 项目生产文件 :包括 project 内容根目录内的所有文件,测试源目录除外。 在 项目 工具窗口(Alt+1 )中,此作用域对应于 生产 视图。

  • 项目测试文件 :包括测试源根目录中的文件。 在 项目 工具窗口(Alt+1 )中,此作用域对应于 测试 视图。

  • 非项目文件 :此范围仅可在 项目 工具窗口中作为视图使用。 它包括库和 SDK。

  • 打开文件 :包括编辑器中当前打开的文件。

  • 当前文件 :对应当前在编辑器中活动的文件。

  • 选定文件 :包含在工具窗口中选定的文件(例如,在 项目 工具窗口(Alt+1 )中)。

  • 类层次结构 :包括与所选类相互关联的类。 在选择此范围后,系统将提示您选择层次结构的基类。

  • 本地更改 (如果 已启用 VCS 集成 ,则会显示这些作用域)

    • 所有更改的文件 :包括尚未添加到 VCS 的所有更改列表中的已修改文件。

    • 默认更改列表 :包括尚未添加到 VCS 的 默认 变更列表中的修改文件。

    • 'Changelist name' :包括尚未添加到 VCS 的特定自定义更改列表中的已修改文件。

将范围与颜色关联

属于不同作用域的文件可以在搜索结果、编辑器选项卡以及 项目 工具窗口(Alt+1 )中以不同颜色高亮显示。

在编辑器选项卡和搜索结果中的范围高亮显示

可以为每个作用域分配专属颜色。 例如,您可以为 打开文件 范围分配一种颜色,并配置 IDE 在 项目 工具窗口中显示此颜色。 在这种情况下,您当前在编辑器中处理的文件将在项目树中以颜色显示。 这使得 project 的导航更快更简单。 请注意,文件颜色只有与作用域关联时才会生效。

同样,颜色关联可以是 局部的和 共享的。

  • 本地颜色 仅对您可见,不会通过 VCS 共享。

  • 共享颜色 会置于版本控制之下,以便参与 project 的人员可以使用相同的颜色关联。 它们存储在 .idea 的 project 文件夹中的 fileColors.xml 文件里(例如: My项目/.idea/fileColors.xml )。

创建新的颜色关联

  1. 按 Ctrl+Alt+S 打开设置,然后选择 外观与行为 | 文件颜色。

  2. 请确保选中 启用文件颜色 复选框,然后选择您要使用颜色的位置:选择 在编辑器标签页中使用 或 在项目视图中使用。

    如果选中 在项目视图中使用 复选框,将在 项目 工具窗口(Alt+1 )和搜索结果中看到颜色(例如,在 在文件中查找 对话框 Ctrl+Shift+F 中)。

  3. 点击 添加 按钮("添加"图标 ),然后选择要为其配置颜色的作用域。

    可以选择一个预定义作用域,或使用 自定义作用域。

  4. 点击所需作用域旁边的箭头 右箭头图标 ,然后从打开的列表中选择一种颜色。

    要配置您自己的颜色,请点击 自定义。

    为自定义范围选择颜色
  5. 要编辑颜色,请点击 颜色 列中与所需作用域对应的单元格,并从列表中选择新颜色。

  6. 要通过 VCS 共享 颜色,请在 通过 VCS 共享 列的相应行中选中复选框。 如果取消选中复选框,颜色将被 本地使用。

    为自定义范围选择另一种颜色
  7. 应用更改并关闭对话框。

如果文件包含在多个作用域中,作用域的顺序就很重要:IntelliJ IDEA 从本地作用域开始,从上到下处理作用域。 这意味着 IDE 会将列表中最后一个作用域的颜色应用于此类文件。

如果希望 IntelliJ IDEA 以不同顺序处理颜色关联,可以更改作用域的顺序。

更改范围顺序

  1. 按 Ctrl+Alt+S 打开设置,然后选择 外观 & 行为 | 作用域。

  2. 选择要移动的作用域,然后点击 上移 ("向上移动"按钮 )或 下移 ("向下移动"按钮 )按钮。 或者,按 Alt+Up 或 Alt+Down。

  3. 应用更改并关闭对话框。

作用域用例

以下示例展示如何在日常工作中使用作用域:

  • 仅检查特定文件组。

    借助作用域,可以检查代码库的特定部分。 例如,可以将生产代码与测试代码分开检查。 此外,可以将另一种检查设置应用于最近修改的文件,以确保新更改经过更严格的检查。

    有关更多信息,请参阅 运行检查。

    指定检查范围对话框
  • 限制搜索和替换结果。

    可以将作用域与 在文件中查找 和 在文件中替换 功能结合使用,以减少不相关结果的数量并加快重构。

    有关更多信息,请参阅 在项目中搜索并替换目标。

    在类层次结构中搜索
  • 使用作用域进行导航。

    在 项目 工具窗口中,作用域还可以 Simplify 导航。 可以选择所需作用域,创建只包含当前所需项的简化树。

    有关更多信息,请参阅 项目工具窗口。

    “项目”工具窗口中的作用域
  • 仅重新格式化某些文件。

    借助作用域,可以重新格式化特定文件,而不是只重新格式化当前文件或整个代码库。 例如,可以在更改代码后重新格式化最近修改的文件,以符合代码样式要求。

    有关更多信息,请参阅 重新格式化代码。

    模块或目录重格式化对话框
  • 为不同的文件设置配置不同的版权声明。

    在多种情况下这会很有用,例如,当项目中的文件有不同的版权所有者,或来自第三方或开源项目,并且需要保留原始版权时。

    有关更多信息,请参阅 版权。

    将配置文件与作用域关联
2026年 11月 3日