PyCharm 2026.1 Help

项目分析

项目分析使 PyCharm 能够启用智能 IDE 功能:代码补全、检查、重构、导航、查找用法和语法高亮显示。

在您打开或克隆新项目、启用或禁用插件以及切换分支后,PyCharm 会触发此过程。 该过程还会在大型外部文件更新后触发(例如,在构建项目时创建或生成多个文件)。

状态栏中的项目分析消息

在分析过程中,PyCharm 会检查您项目中的代码,以创建由类、方法、对象及构成应用程序的其他代码元素组成的虚拟映射。 此过程的结果为项目文件索引,从而使 IDE 能够即时提供智能功能,例如编码辅助、搜索、导航等。

在分析进行时,智能 IDE 功能可能不可用或部分可用。 不过,这不会阻止您使用 PyCharm:您仍可编写代码、使用 VCS 功能、配置设置以及执行其他与代码无关的操作。

跟踪项目分析进度

当项目分析正在运行时,您可以在位于 PyCharm 底部的 状态栏中跟踪其进度。

在 PyCharm 右下角等待扫描完成

如果您点击状态栏,将会打开 进程 对话框,您可以在其中查看当前正在进行或排队的进程。

包含项目分析任务的进程对话框

项目分析的主要流程包括:

  • 正在扫描文件 :检查应分析哪些文件。 该过程无法暂停或取消。

  • 正在分析项目以启用智能功能 :检查并索引文件内容。 该过程可以暂停(并恢复),但无法取消。

您可以在进度条下方检查每个进程的状态。 当所有项目分析进程完成时,PyCharm 会清空状态栏。 这表示智能 IDE 功能(如编码辅助和查找用法)已准备就绪。

减少项目分析时间

分析项目所需的时间取决于其规模:项目越复杂,包含的文件越多,IDE 分析所需的时间就越长。 您可以通过 排除文件和文件夹来减少项目分析时间。

从项目分析中排除文件和文件夹

您可以将动态生成的文件和文件夹标记为已排除,以加快项目分析并提升 IDE 的整体性能。 被排除的文件和文件夹在项目分析期间不会被索引(因此智能 IDE 功能对其不可用),但它们仍属于项目的一部分。

从项目分析中排除文件

  1. 转到 项目 工具窗口(Alt+1)。

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

    纯文本文件会标有 由水平线表示的纯文本图标 图标。

从项目分析中排除文件夹

  1. 转到 项目 工具窗口(Alt+1)。

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

    已排除的文件夹会标有 由橙色文件夹表示的已排除根目录图标 图标。

2026年 3月 24日