项目工具窗口

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

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

该视图还包含临时文件与控制台文件夹，可用于管理已创建的 scratch files、查询控制台和扩展脚本。

视图

工具窗口有几个视图：

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

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

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

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

外观和行为

快速添加文件和文件夹

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

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

预览文件

有两种方法无需在单独的选项卡中打开文件即可预览：

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

显示文件大小和修改时间

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

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

显示树缩进指南

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

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

点击一次即可打开文件

您可以配置项目工具窗口，使其通过单击一次即可在编辑器中打开文件。

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

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

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

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

标题上下文菜单

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

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

项目

快捷方式

描述

选择下一个视图或标签页

Alt+Right

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

仅当分组选项卡被禁用时，此选项才可用。

选择前一个视图或标签

Alt+Left

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

仅当分组选项卡被禁用时，此选项才可用。

显示视图或选项卡列表

Alt+Down

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

仅当分组选项卡被禁用时，此选项才可用。

行为

启用预览标签页

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

一键打开文件

通过点击项目工具窗口中的项目，在编辑器中打开该项目。否则，您需要双击项目才能打开它们。

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

单击一次打开目录

通过点击项目工具窗口中的目录，可以展开和折叠目录。否则，您需要双击目录以将其打开，或者使用目录名称旁边的图标。

始终选择打开的文件

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

外观

成员

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

成员：开启	成员：关闭

排除的文件

仅在项目视图中提供此选项。

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

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

临时文件与控制台

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

该节点包含您的 scratch files 和查询控制台。

文件详情

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

文件嵌套

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

自定义树视图

请导航至设置 | 外观与行为 | 外观 | 树视图配置树视图选项。

排序方式

名称

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

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

按类型分组

按文件扩展名排序。

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

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

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

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

文件夹总在最前

如果该选项开启，文件夹将显示在文件上方。否则，所有项目按字母顺序排序，文件和文件夹会混在一起显示。

编辑范围

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

请注意，此命令仅在当前视图为 scope 视图时可用。

快速搜索

Ctrl+F

搜索项目。了解更多工具窗口中的 Speed Search

标签页分组

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

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

分组标签：已启用	分组标签：已禁用

视图模式

该选项允许您控制工具窗口的一般外观与行为。有关完整信息，请参阅工具窗口视图模式。

移至

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

调整大小

要通过移动工具窗口的某个边界来调整其大小，请选择此命令，然后选择必要的延展至选项。

请注意，此命令在浮动模式下不可用。

从边栏中移除

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

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

帮助

此命令会在 PyCharm 在线帮助中打开项目工具窗口的描述。

标题栏操作

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

内容窗格

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

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

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

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

项目的上下文菜单可访问该项目的所有功能。

项目	快捷键	描述
新建	`Alt+Insert`	在选定项（目录、文件或类）内创建一个新项。（项目或目录）。
更改课程信息		此功能在 PyCharm 教育功能启用时可用。有关更多信息，请参阅 PyCharm 教育版。此命令仅对教育者可用。有关更多信息，请参阅教育者入门指南。选择此命令以显示更改课程信息对话框，您可以在其中更改课程标题、描述和作者。
生成课程归档		此功能在 PyCharm 教育功能启用时可用。有关更多信息，请参阅 PyCharm 教育版。此命令仅对教育者可用。有关更多信息，请参阅教育者入门指南。选择此命令以在指定位置创建课程的 zip 归档。
上传课程到 Stepic		此功能在 PyCharm 教育功能启用时可用。欲了解更多信息，请参阅 PyCharm 教育版。此命令仅对教育者可用。有关更多信息，请参阅教育者入门指南。选择此命令通过 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		使用此命令通过 gists 分享代码。

文件状态高亮

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

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

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

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

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

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

文件颜色

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

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

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