PyCharm 2025.3 Help

PSI 查看器

工具 | 查看 PSI 结构

使用 PSI 查看器 ,您可以按照 PyCharm 的解释方式探索源代码的内部结构。

查看您源代码的 PSI 结构

  1. 工具 菜单中,选择 查看 PSI 结构

  2. PSI 查看器 对话框中,在 文本 区域键入或粘贴要分析的源代码片段,选择文件类型,并指定其他选项。

    • 显示以下内容的 PSI 结构 列表中,选择要探索的文件类型或语言结构。 可识别的文件类型集合取决于支持的语言和已安装的插件。

    • 选中 显示 PsiWhiteSpace 复选框以显示与源代码中空格相对应的 PsiWhiteSpace 节点。

    • 文本 窗格中,输入要探索的源代码。 手动键入文本或从剪贴板粘贴。 如果您从编辑器复制了一些文本,然后打开 PSI 查看器,则会选中 文本 窗格的先前内容,您可以使用 Ctrl+VCtrl+Shift+V 从剪贴板将其覆盖。

      在输入代码时,您可以按 Ctrl+Y 删除插入符号处的行,使用 Ctrl+D 重复文本,并使用 Shift+Enter 添加行。

  3. 点击 构建 PSI 树 以生成 PSI 结构树视图,并在 PSI 结构 窗格中预览生成的 PSI 树。

    如果 文本 窗格中的源代码被修改,请点击 构建 PSI 树 刷新树视图。

    在树视图中导航时,会高亮显示 文本 窗格中相应的源代码片段。 如果当前选定的树节点具有引用,它们也会显示在 引用 窗格中。

    引用 只读字段显示对 PSI 结构树视图节点的引用(如果有)。

    未解析的引用显示为红色;相应的源代码片段也会以红色边框高亮显示。

项目

描述

显示以下内容的 PSI 结构

使用此列表指定要探索的文件类型或语言结构。 可识别的文件类型集合取决于支持的语言和已安装的插件。

显示 PsiWhiteSpace

选中此复选框后,生成的树视图将包含 PsiWhiteSpace 节点,对应于源代码中的空格。 选中或清除此复选框时,PSI 结构的树视图会相应更改。

显示树节点

方言

此列表适用于支持方言的语言,例如 SQL、JavaScript 等。

文本

使用此窗格输入要探索的源代码。 PyCharm 提供以下输入代码的方法:

  • 直接在文本区域中键入。

  • 从剪贴板粘贴文本。 如果您从编辑器复制了一些文本,然后打开 PSI 查看器,则会选中 文本 窗格的先前内容,您可以使用 Ctrl+VCtrl+Shift+V 从剪贴板将其覆盖。

请注意,还可使用一些编辑功能:在插入符号处删除行 Ctrl+Y 、重复文本 Ctrl+D 、以及使用 Shift+Enter 添加行。

PSI 结构

此只读窗格显示 PSI 结构树视图;点击 构建 PSI 树 按钮后,会根据 显示以下内容的 PSI 结构 列表中选择的文件类型生成。

在树视图中导航时,会高亮显示 文本 窗格中相应的源代码片段。 如果当前选定的树节点具有引用,它们也会显示在 引用 窗格中。

引用

此只读字段显示对 PSI 结构树视图节点的引用(如果有)。

未解析的引用显示为红色;相应的源代码片段也会以红色边框高亮显示。

构建 PSI 树

点击此按钮可根据 显示以下内容的 PSI 结构 列表中选择的文件类型,为 文本 窗格中的代码生成 PSI 结构树视图。

如果 文本 窗格中的源代码被修改,请点击此按钮刷新树视图。

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