PyCharm 2025.2 Help

作用域

使用此设置页面定义作用域——应用不同操作的文件集。

主工具栏

项目

提示

描述

添加按钮

添加作用域

Alt+Insert

添加新的 本地共享作用域。

"移除"按钮

删除

Alt+Delete

从列表中删除所选作用域。

复制配置按钮

复制配置

Ctrl+D

创建所选作用域的副本。

“另存为”按钮

另存为

将选定的本地作用域另存为共享作用域,或将选定的共享作用域另存为本地作用域。

上移按钮   下移按钮

上移/下移

在列表中上下移动作用域。

作用域配置控制

项目

描述

名称(M)

指定作用域名称。

模式(P)

指定定义当前作用域的模式。 以下元素和结构可以使用:

  1. file: 修饰符。 该元素是必需的。

  2. 文件名或文件扩展名中使用 * 星号表示任意符号。

  3. 逻辑运算符 AND (&&), OR (||) 、和 NOT (!)

欲了解更多信息,请参阅 作用域语言语法参考

不允许存储空或错误的模式。 在这种情况下,PyCharm 显示 Syntax Error 警告。

示例

  • file:*.js||file:*.coffee - 包括所有 JavaScript 和 CoffeeScript 文件。

  • file:*js&&!file:*.min.* - 包含所有 JavaScript 文件,但通过 minification 生成的文件除外,这些文件由 min 扩展名指示。 了解更多 压缩 JavaScript

  • !file:*/.npm//* - 排除所有 .npm 文件夹。

  • file[Scientific_Sample]:*.py - 包含项目 Scientific_Sample 中的所有 Python 文件。 在括号中指定项目名称在您附加了多个项目时特别有用。

    为两个附加项目创建的范围示例

包含

已包含所选项目。 如果当前项目是文件夹,则嵌套的子文件夹将被忽略。

递归包含

包括所选文件夹及其所有嵌套子文件夹和它们的内容。

排除

排除选定项。 如果当前项目是一个文件夹,则嵌套的子文件夹将保留在作用域内。

递归排除

排除所选文件夹及其所有嵌套子文件夹及其内容。

作用域工具栏

项目

提示

描述

项目树视图

树状视图包含项目中所有可用的文件。 在视图中,选择要包含在当前作用域内的文件,作用域定义模式将自动生成。

显示文件

显示文件

启用此选项时,源文件会在树形视图中显式显示。 当文件显示时,您可以选择将其排除/包含在模式中。

如果此选项未被禁用,所有文件将在树中隐藏。

显示模块按钮

显示模块

启用此选项时,树视图中的项目将显示在相应的模块节点下。 否则,项目项显示在对应的包下(如具有包的源路径)。

仅显示包含的内容

仅显示包含的文件

启用此选项时,树仅显示包含在作用域内的元素。

项目树视图的图例

项目

描述

绿色示例

在作用域内包含的文件夹和文件将用绿色标记。

深蓝色样本

包含被排除和包含的文件及子文件夹的文件夹会被标记为深蓝色。

最后修改日期: 2025年 9月 26日