项目工具窗口

通过项目工具窗口 Alt+1 ，您可以从不同视角查看您的项目，并执行创建新项（目录、文件、类等）、在编辑器中打开文件、导航到所需代码片段等任务。

此工具窗口中的大多数功能可作为内容窗格中的上下文菜单命令使用，并可通过相关快捷键访问。

该视图还包含临时文件与控制台文件夹，您可以在其中管理已创建的临时文件、查询文件和扩展脚本。

视图

该工具窗口包含多个视图：

项目视图。此视图显示所有项目项以及其依赖项（ SDK 和库）。该视图侧重于目录结构，同时也会显示包。
作用域视图（项目文件、打开的文件等）。这些视图显示预定义与用户自定义的作用域的内容。在其他方面，根据当前选择的视图选项，作用域视图可能类似于项目或包视图。

要在视图之间切换，请按 Alt+Right/Alt+Left ，或从标题栏中的列表选择一个视图。

您也可以在单独的选项卡中显示每个视图：点击并禁用标签页分组选项。

要配置视图，请使用标题栏上下文菜单中的相应选项。您也可以点击标题栏中的来访问所需选项。

外观与行为

快速添加文件和文件夹

您可以从工具窗口工具栏创建新文件或文件夹。可用选项取决于工具窗口中所选的节点。

在工具窗口工具栏上点击，然后从列表中选择一个选项。
使用快速搜索更快速地查找选项：开始键入要创建的文件类型以缩小结果范围。

预览文件

有两种方式可在不将每个文件单独在选项卡中打开的情况下预览文件：

使用文件预览弹出窗口：在项目工具窗口 Alt+1 中选择一个文件，然后按 Space。
启用预览选项卡：点击并选择行为 | 启用预览标签页。

显示文件大小和修改时间戳

您可以在项目树中查看文件的大小和修改时间戳。

在项目工具窗口 Alt+1 中，点击并选择外观 | 文件详细信息。

显示树形缩进线

在项目工具窗口中，您可以显示标记缩进级别的竖线，以帮助您更好地理解项目中各组件的层次结构。

按 Ctrl+Alt+S 打开设置，然后选择外观与行为 | 外观。
在树视图部分，启用显示缩进引导线选项。

点击打开文件

您可以将项目工具窗口配置为在编辑器中通过点击一次打开文件。

在项目工具窗口中，点击并启用行为 | 一键打开文件选项。

在项目工具窗口中快速定位文件

PyCharm 可通过在项目工具窗口中自动选择，帮助您跟踪活动编辑器选项卡中当前打开的文件。

在项目工具窗口中，点击并启用行为 | 始终选择打开的文件选项。

标题栏上下文菜单

通过右键点击标题或点击选项按钮打开的上下文菜单，为项目视图、查看模式提供设置，还可在视图之间切换、调整工具窗口大小等。

下表列出了可用命令和选项并进行了简要说明。

项

快捷键

描述

选择下一个视图或选项卡

Alt+Right

使用此选项在不同视图之间切换。

仅当禁用选项卡分组时可用。

选择上一个视图或选项卡

Alt+Left

使用此选项在不同视图之间切换。

仅当禁用选项卡分组时可用。

显示视图或选项卡列表

Alt+Down

使用此选项在不同视图之间切换。

仅当禁用选项卡分组时可用。

行为

启用预览标签页

启用预览选项卡，在单个选项卡中逐个查看文件，而无需为每个文件打开新选项卡。

一键打开文件

在项目工具窗口中点击一次该项，即可在编辑器中将其打开。否则，您需要双击项才能打开。

请注意，如果启用了预览选项卡，则无法禁用此选项。

点击一次打开目录

在项目工具窗口中点击一次目录即可展开或折叠它们。否则，您需要双击目录以将其打开，或使用目录名称旁的图标。

始终选择打开的文件

如果启用此选项， PyCharm 会在此窗口的当前视图中自动定位您在编辑器中打开的文档。

外观

成员

如果启用此选项，树中包含类的文件将转换为节点。展开此类节点时，会显示其中的类及其字段、方法和所选项的其他成员。

成员：开启	成员：关闭

已排除的文件

此选项仅在项目视图中可用。

打开或关闭此选项以显示或隐藏排除的文件夹和文件。

排除的文件：开启	排除的文件：关闭

临时文件与控制台

隐藏或显示临时文件与控制台节点。

该节点包含您的临时文件和查询文件。

文件详细信息

选择此选项以显示文件的大小和修改时间戳。

文件嵌套

打开文件嵌套对话框，您可以在其中配置同名不同扩展名文件的呈现方式。

自定义树视图

转到设置 | 外观与行为 | 外观 | 树视图以配置树形视图选项。

排序方式

名称

按名称字母顺序对文件排序。

该选项不影响文件夹的顺序，文件夹始终按字母顺序排序。

类型

按扩展名对文件排序。

该选项不影响文件夹的顺序，文件夹始终按字母顺序排序。

修改时间（最新优先／最旧优先）

按修改时间对文件排序。要显示此信息，请从主菜单中选择视图 | 外观 | 树视图中的详细信息。

该选项不影响文件夹的顺序，文件夹始终按字母顺序排序。

文件夹总在最前

如果启用该选项，文件夹将显示在文件上方。否则，所有项按字母顺序排序，文件与文件夹将混合显示。

编辑范围

打开范围对话框，您可以在其中创建和编辑用户定义的作用域。

请注意，仅当当前视图为作用域视图时，此命令才可用。

快速搜索

Ctrl+F

搜索项。了解更多内容，请参阅工具窗口中的快速搜索

标签页分组

如果启用此选项，标题左侧将显示一个列表，您可以从中选择所需视图。

如果禁用此选项，视图将以选项卡的形式显示在标题的左侧。

分组选项卡：开启	分组选项卡：关闭

视图模式

此选项可让您控制工具窗口的一般外观和行为。有关完整信息，请参阅工具窗口视图模式。

移至

要将工具窗口与其他工具窗口栏关联，请选择此命令，然后选择目标工具窗口栏（顶部、左侧、底部或右侧）。有关完整信息，请参阅移动工具窗口章节。

调整大小

要通过移动其边框之一来调整工具窗口大小，请选择此命令，然后选择所需的拉伸至选项。

请注意，此命令不适用于浮动模式。

从边栏中移除

此命令会隐藏工具窗口，从工具窗口栏中移除关联的工具窗口按钮，并将该工具窗口从快速访问菜单（或）中移除。

要重新打开该工具窗口（并恢复关联功能），请使用主菜单：视图 | 工具窗口 | <窗口名称> ，或按 Alt+1。

帮助

此命令将在 PyCharm 在线帮助中打开项目工具窗口的说明。

标题栏操作

项	快捷键	描述
选择下一个视图或选项卡选择上一个视图或选项卡	`Alt+Right` `Alt+Left`	如果视图当前以选项卡形式显示（分组选项卡选项已关闭），此按钮将出现在最后一个可见选项卡的右侧。打开视图列表，例如选择不同的视图。
		从编辑器中的文件导航到项目工具窗口 `Alt+1` 中的相应节点（文件、类、字段、方法等）。如果当前启用了始终选择已打开的文件选项，则此图标不可用。
	`Ctrl+NumPad +`	展开所有节点。
	`Ctrl+NumPad -`	折叠所有节点。
		打开菜单以配置当前视图并更改工具窗口的查看模式。可用选项是标题栏上下文菜单项的子集。请注意，大多数菜单项都是可打开或关闭的选项。已开启的选项在其名称左侧带有复选标记。编辑作用域显示成员点击打开文件始终选择已打开的文件按类型排序文件夹始终在顶部显示排除的文件固定模式、停靠模式、浮动模式、窗口模式、拆分模式从侧边栏移除分组选项卡移动到调整大小
	隐藏 `Shift+Escape`	隐藏工具窗口 `Shift+Escape`。要隐藏所有工具窗口，请按 `Ctrl+Shift+F12`。

内容窗格

内容窗格显示项目项，例如目录、文件和其他元素。

下表展示并简要说明了主要类别（节点类型）的图标。用于主要符号（类、字段、方法等）、可见性修饰符和书签的图标请参见图标参考。

项	描述
	包
	文件夹（目录）。不同类别的文件夹具有不同的颜色。目录排除的文件夹
	外部库，用于分组与项目关联的第三方软件的类别。仅在选择项目视图时显示该节点。
	您的临时文件和控制台会分组显示在此节点下。

内容窗格项的上下文菜单命令

项的上下文菜单提供对该项所有可用功能的访问。

项	快捷键	描述
新建	`Alt+Insert`	在所选项内创建新项（目录、文件或类）。（项目或目录）。
更改课程信息		此功能在启用 PyCharm 教学功能时可用。有关更多信息，请参阅 PyCharm 教育版。此命令仅对教育者可用。有关更多信息，请参阅 Educator Start Guide。选择此命令以显示更改课程信息对话框，您可以在其中更改课程标题、描述和作者。
生成课程归档		此功能在启用 PyCharm 教学功能时可用。有关更多信息，请参阅 PyCharm 教育版。此命令仅对教育者可用。有关更多信息，请参阅 Educator Start Guide。选择此命令在指定位置创建课程的 zip 归档。
将课程上传到 Stepic		此功能在启用 PyCharm 教学功能时可用。有关更多信息，请参阅 PyCharm 教育版。此命令仅对教育者可用。有关更多信息，请参阅 Educator Start Guide。选择此命令通过 Stepic 分享您的课程。必须拥有 Stepic 帐户。
剪切	`Ctrl+X`	将所选项从当前位置移动到剪贴板。
复制(C)	`Ctrl+C`	将所选项复制到剪贴板。
复制路径/引用		使用此命令并选择以下选项之一，将所选项复制到剪贴板：绝对路径：复制所选项的完整路径。文件名：仅将文件名复制到剪贴板。来自内容根的路径：复制相对于包含应用程序内容文件的目录的路径。来自源根的路径：复制相对于源代码根的路径。仓库根路径：复制相对于项目存储库的路径。 GitHub 仓库 URL ：复制相对于 GitHub 上的项目存储库的路径。工具箱URL ：如果已安装 PyCharm Toolbox，您可以在浏览器中粘贴复制的路径，以使用所选项目打开 Toolbox 应用程序。复制引用(Y) （`Ctrl+Alt+Shift+C` ）：复制所选项的引用（包括行号）。
粘贴	`Ctrl+V`	将剪贴板的内容插入到所选位置。
跳转到源	`F4`	在编辑器中打开所选文件。如果该文件已打开，则相应的编辑器选项卡将变为活动状态。
查找用法	`Alt+F7`	搜索所选项的用法。（将打开查找用法对话框。）
在文件中查找	`Ctrl+Shift+F`	执行文本搜索。（将打开在文件中查找对话框。）
在文件中替换	`Ctrl+Shift+R`	执行文本搜索并替换。（将打开在路径中替换对话框。）
重命名	`Shift+F6`	重命名所选项。
重构		执行所选项可用的重构之一。例如，您可以重命名、移动并复制文件和目录。
书签		将所选项添加到现有或新的书签列表。
重新格式化代码	`Ctrl+Alt+L`	重新格式化所选文件中的源代码，或当前目录中所有文件的源代码。参见重新格式化并重排代码。
删除	`Delete`	删除所选项。请谨慎使用！
运行 '<item_name>'	`Ctrl+Shift+F10`	运行测试配置。
调试 '<item_name>'	`⌃ ⇧ D`	调试测试配置。
使用覆盖率运行 '<item_name>'		使用此命令通过 coverage.py 运行测试配置。要启用覆盖率，请在设置 \| 构建、执行、部署 \| 覆盖率中选中使用捆绑的 coverage.py 复选框。
分析 '<item_name>'		使用此命令，您可以将 Python 分析器附加到当前运行/调试配置。
'<item_name>' 的并发图		使用此命令，您可以使用当前运行/调试配置运行并发可视化会话。
在右侧拆分中打开	`Shift+Enter`	将编辑器分为两部分，并在右侧区域显示该文件。有关更多信息，请参阅拆分屏幕。
在以下位置打开		在系统文件管理器或终端中打开文件。
在终端中打开		使用此命令在终端中打开与所选项对应的目录。
本地历史记录		查看所选文件或目录的本地历史记录，或为您的项目的当前版本创建标签。
同步 '<item_name>'		将工具窗口中的视图与文件系统中保存的视图同步。如果您在外部更改了文件或目录的内容，在某些情况下，除非使用此命令，否则 PyCharm 可能无法获知相应更改。
与…比较	`Ctrl+D`	将所选文件或目录与另一个文件或目录进行比较。参见比较文件、文件夹和文本源和文件夹差异查看器。
将文件与编辑器进行比较		将所选文件与活动编辑器选项卡中打开的文件进行比较。参见比较文件、文件夹和文本源和文件差异查看器。
外部工具		启动第三方工具。
标记目录为		将所选目录标记为源代码根或测试源代码根、将该目录标记为排除等。从子菜单中为该目录选择所需类别。有关目录类别的更多信息，请参阅内容根。
图表	`Ctrl+Alt+Shift+U` 或 `Ctrl+Alt+U`	为所选项打开图表（例如 UML 图表）。
创建 Gist		使用此命令通过 gist 分享代码。

文件状态高亮显示

如果已为当前项目启用 VCS 集成，PyCharm 会在项目工具窗口中使用颜色表示 VCS 文件状态。

您可以在版本控制 | 文件状态颜色设置页面  Ctrl+Alt+S 上配置 VCS 文件状态的颜色。

下表列出了某些配色方案中的默认文件状态颜色及其含义。

颜色	文件状态	描述
#0A7700	已添加	活动变更列表中的文件已计划添加到存储库。
#0EAA00	在非活动变更列表中已添加	非活动变更列表中的文件已计划添加到存储库。如果在设置 \| 版本控制 \| 更改列表中启用了高亮显示非活动更改列表中的文件选项，则会显示此文件状态。
#FF0000	变更列表冲突	非活动变更列表中的文件在活动变更列表中已被修改。在这种情况下，会打开一个新对话框，提示您解决变更列表冲突。如果在设置 \| 版本控制 \| 更改列表中启用了所有选项，则会显示此文件状态。
#0A7700	已复制	如果文件是另一个文件的副本，其元数据会被跟踪，并将该文件标记为已复制。
#616161	已删除	该文件已计划从存储库中删除。
#773895	已从文件系统删除	该文件已在本地删除，但尚未计划删除，且仍存在于存储库中。
#8AA4C8	包含已更改的后代	如果某个文件被修改，IDE 将递归高亮显示包含该文件的所有目录。如果在设置 \| 版本控制 \| 确认中启用了在项目树中高亮显示包含已修改文件的目录选项，则会显示此状态。
#3264B4	包含已更改的直接子项	如果某个文件被修改，IDE 将高亮显示其父目录。如果在设置 \| 版本控制 \| 确认中启用了在项目树中高亮显示包含已修改文件的目录选项，则会显示此状态。
#B28C00	劫持	[Perforce, ClearCase, VSS] 该文件未签出而被修改。
#727238	已忽略	文件被 VCS 有意忽略。
#7503DC	已合并	该文件在更新后由您的 VCS 合并。
#FF0000	合并存在冲突	在最后一次更新期间，文件已合并并出现冲突。
#FF0000	合并存在属性冲突	在最后一次更新期间，IDE 检测到本地文件的属性与其服务器版本之间存在差异。
#FF0000	合并存在文本和属性冲突	当两个或更多开发人员修改同一文件的相同行以及相同的文件属性时，会发生文本和属性冲突。
#0032A0	已修改	自上次同步以来，该文件已发生更改。
#0047E4	在非活动变更列表中已修改	非活动变更列表中的文件已被修改。如果在设置 \| 版本控制 \| 更改列表中启用了高亮显示非活动更改列表中的文件选项，则会显示此文件状态。
#7C7C00	已过时	该文件不应再出现在您存储库的工作副本中。
#007C7C	已重命名	自最后一次更新以来，该文件已被重命名。
#08978F	已切换	[SVN] 该文件来自与整个项目不同的分支。
#993300	（未知）未纳入版本控制	该文件在本地存在，但不在存储库中，且未计划添加。
None (default color)	最新	该文件未发生更改。

颜色	文件状态	描述
#629755	已添加	活动变更列表中的文件已计划添加到存储库。
#629755	在非活动变更列表中已添加	非活动变更列表中的文件已计划添加到存储库。如果在设置 \| 版本控制 \| 更改列表中启用了高亮显示非活动更改列表中的文件选项，则会显示此文件状态。
#D5756C	变更列表冲突	非活动变更列表中的文件在活动变更列表中已被修改。在这种情况下，会打开一个新对话框，提示您解决变更列表冲突。如果在设置 \| 版本控制 \| 更改列表中启用了所有选项，则会显示此文件状态。
#0A7700	已复制	如果文件是另一个文件的副本，其元数据会被跟踪，并将该文件标记为已复制。
#6C6C6C	已删除	该文件已计划从存储库中删除。
#6C6C6C	已从文件系统删除	该文件已在本地删除，但尚未计划删除，且仍存在于存储库中。
#6897BB	包含已更改的后代	如果某个文件被修改，IDE 将递归高亮显示包含该文件的所有目录。如果在设置 \| 版本控制 \| 确认中启用了在项目树中高亮显示包含已修改文件的目录选项，则会显示此状态。
#6897BB	包含已更改的直接子项	如果某个文件被修改，IDE 将高亮显示其父目录。如果在设置 \| 版本控制 \| 确认中启用了在项目树中高亮显示包含已修改文件的目录选项，则会显示此状态。
None (default color)	劫持	[Perforce, ClearCase, VSS] 该文件未签出而被修改。
#848504	已忽略	文件被 VCS 有意忽略。
#9876AA	已合并	该文件在更新后由您的 VCS 合并。
#D5756C	合并存在冲突	在最后一次更新期间，文件已合并并出现冲突。
#D5756C	合并存在属性冲突	在最后一次更新期间，IDE 检测到本地文件的属性与其服务器版本之间存在差异。
#D5756C	合并存在文本和属性冲突	当两个或更多开发人员修改同一文件的相同行以及相同的文件属性时，会发生文本和属性冲突。
#6897BB	已修改	自上次同步以来，该文件已发生更改。
#6897BB	在非活动变更列表中已修改	非活动变更列表中的文件已被修改。如果在设置 \| 版本控制 \| 更改列表中启用了高亮显示非活动更改列表中的文件选项，则会显示此文件状态。
None (default color)	已过时	该文件不应再出现在您存储库的工作副本中。
#3A8484	已重命名	自最后一次更新以来，该文件已被重命名。
None (default color)	已切换	[SVN] 该文件来自与整个项目不同的分支。
#D1675A	（未知）未纳入版本控制	该文件在本地存在，但不在存储库中，且未计划添加。
None (default color)	最新	该文件未发生更改。

颜色	文件状态	描述
#62CC47	已添加	活动变更列表中的文件已计划添加到存储库。
#62CC47	在非活动变更列表中已添加	非活动变更列表中的文件已计划添加到存储库。如果在设置 \| 版本控制 \| 更改列表中启用了高亮显示非活动更改列表中的文件选项，则会显示此文件状态。
#FF6666	变更列表冲突	非活动变更列表中的文件在活动变更列表中已被修改。在这种情况下，会打开一个新对话框，提示您解决变更列表冲突。如果在设置 \| 版本控制 \| 更改列表中启用了所有选项，则会显示此文件状态。
#62CC47	已复制	如果文件是另一个文件的副本，其元数据会被跟踪，并将该文件标记为已复制。
#ED864A	已删除	该文件已计划从存储库中删除。
#ED864A	已从文件系统删除	该文件已在本地删除，但尚未计划删除，且仍存在于存储库中。
#4FF0FF	包含已更改的后代	如果某个文件被修改，IDE 将递归高亮显示包含该文件的所有目录。如果在设置 \| 版本控制 \| 确认中启用了在项目树中高亮显示包含已修改文件的目录选项，则会显示此状态。
#4FF0FF	包含已更改的直接子项	如果某个文件被修改，IDE 将高亮显示其父目录。如果在设置 \| 版本控制 \| 确认中启用了在项目树中高亮显示包含已修改文件的目录选项，则会显示此状态。
None (default color)	劫持	[Perforce, ClearCase, VSS] 该文件未签出而被修改。
#A9B837	已忽略	文件被 VCS 有意忽略。
#ED94FF	已合并	该文件在更新后由您的 VCS 合并。
#FF6666	合并存在冲突	在最后一次更新期间，文件已合并并出现冲突。
#FF6666	合并存在属性冲突	在最后一次更新期间，IDE 检测到本地文件的属性与其服务器版本之间存在差异。
#FF6666	合并存在文本和属性冲突	当两个或更多开发人员修改同一文件的相同行以及相同的文件属性时，会发生文本和属性冲突。
#4FF0FF	已修改	自上次同步以来，该文件已发生更改。
#4FF0FF	在非活动变更列表中已修改	非活动变更列表中的文件已被修改。如果在设置 \| 版本控制 \| 更改列表中启用了高亮显示非活动更改列表中的文件选项，则会显示此文件状态。
None (default color)	已过时	该文件不应再出现在您存储库的工作副本中。
#4FF0FF	已重命名	自最后一次更新以来，该文件已被重命名。
None (default color)	已切换	[SVN] 该文件来自与整个项目不同的分支。
D1675A	（未知）未纳入版本控制	该文件在本地存在，但不在存储库中，且未计划添加。
None (default color)	最新	该文件未发生更改。

文件颜色

属于不同作用域的文件（例如生产文件或测试文件）可在项目工具窗口、搜索结果和编辑器选项卡中以不同颜色高亮显示。

您可以为每个作用域分配其自己的颜色。有关更多信息，请参阅将作用域与颜色关联。

最后修改日期： 2025年 12月 2日