PhpStorm 2026.1 Help

项目分析

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

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

状态栏中的项目分析信息

分析过程中,PhpStorm 会检查您项目中的代码,以创建由类、方法、对象和其他代码元素组成的虚拟映射,这些元素构成您的应用程序。 此过程的结果是项目文件索引,IDE 可借此即时提供如编码辅助、搜索、导航等智能功能。

分析进行时,智能 IDE 功能可能不可用或部分可用。 不过,这不会影响您使用 PhpStorm——您仍可编写代码、使用 VCS 功能、配置设置和进行其他与代码无关的操作。

跟踪项目分析进度

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

在 PhpStorm 右下角等待扫描完成

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

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

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

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

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

您可以在每个进度条下方查看各流程的状态。 当项目分析的所有流程完成时,PhpStorm 会清除状态栏。 这表示智能 IDE 功能(如编码辅助和用法查找)已可使用。

减少项目分析时间

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

您可以通过多种方式加快项目分析速度:

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

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

从项目分析中排除文件

  1. 打开 Project 工具窗口(Alt+1)。

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

    纯文本文件标有 由横线组成的纯文本图标 图标。

从项目分析中排除文件夹

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

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

    排除的文件夹会被标记为 用橙色文件夹表示的已排除根节点图标 图标。

2026年 3月 17日