# XPath 表达式评估

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

在将 XPath 表达式用于程序代码或 XSLT 脚本之前，或者在针对 XML 文档进行结构化查询之前，需要对其进行评估以进行测试。

IntelliJ IDEA 允许您以两种模式评估 XPath 表达式：

* 在 简单 模式下，您可以输入不需要任何命名空间前缀自定义的简单单行表达式。 此模式不允许您配置 Context 设置或使用预定义变量。

* 在 高级 模式下，您可以方便地在多行模式中编辑长表达式和编辑 XPath 上下文。

某些错误检查和 XPath 检查还提供了快速修复检测到的问题，例如，通过意图将未解析的 namespace-prefix 映射到 URI 的可能性。

Procedure: 启用 XPathView + XSLT 插件

此功能依赖于 [XPathView + XSLT](https://plugins.jetbrains.com/plugin/12478-xpathview--xslt)插件，该插件默认在 IntelliJ IDEA 中捆绑并启用。 如果相关功能不可用，请确保您没有禁用插件。

> **Note:**
> XPathView + XSLT 插件默认仅在 IntelliJ IDEA Ultimate 订阅中可用。 对于 IntelliJ IDEA，您需要按 [插件](managing-plugins.html) 中的说明安装 XPathView + XSLT 插件。

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `插件` 。

2. 找到  XPathView + XSLT  插件并点击   启用  。

Procedure: 评估 XPath 表达式

1. 从活动编辑器选项卡的上下文菜单中选择   评估 XPath   或转到  `编辑｜查找｜评估 XPath` 。   计算 XPath 表达式   对话框将打开。

2. 要切换评估模式，请点击   高级  /   简单   按钮。 在任一模式下，对话框功能包括最近评估表达式的历史记录、代码补全、语法检查和高亮显示，以及一些对输入表达式的语义错误检查。 语义检查包括对使用的命名空间前缀进行验证、无用的 XPath 表达式（例如，  `@comment()` ）和节点测试，以确保在上下文文档中不存在的元素/属性名称不会被成功匹配。

3. 浏览表达式历史记录：

* 在 简单 模式下，可以从下拉列表中选择最近使用的表达式。

* 在 高级 模式中，使用 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.up.svg)/ ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.down.svg)或者按 `Alt+Up` (Windows), `⌃ ⇧ ↑` (macOS), `⌃ ↑` (IntelliJ IDEA Classic (macOS)), `⌃ ⌥ ↑` (macOS System Shortcuts), `Alt+Up` (XWin), `Alt+Up` (GNOME), `Alt+Up` (KDE), `Alt+Up` (Emacs), `Alt+Up` (Sublime Text), `Alt+Up` (Sublime Text (macOS)), `Alt+Up` (Visual Studio), `⌃ ⇧ ↑` (Visual Studio (macOS)), `Ctrl+Alt+Up` (NetBeans), `Ctrl+Shift+Up` (Eclipse), `⌃ ⌥ ↑` (Eclipse (macOS))/ `Alt+Down` (Windows), `⌃ ⇧ ↓` (macOS), `⌃ ↓` (IntelliJ IDEA Classic (macOS)), `⌃ ⌥ ↓` (macOS System Shortcuts), `Alt+Down` (XWin), `Alt+Down` (GNOME), `Alt+Down` (KDE), `Alt+Down` (Emacs), `Alt+Down` (Sublime Text), `Alt+Down` (Sublime Text (macOS)), `Alt+Down` (Visual Studio), `⌃ ⇧ ↓` (Visual Studio (macOS)), `Ctrl+Alt+Down` (NetBeans), `Ctrl+Shift+Down` (Eclipse), `⌃ ⌥ ↓` (Eclipse (macOS))。

4. 要重新配置 XPath context，请点击   编辑上下文  。 在打开的对话框中，给上下文文档中使用的命名空间 URI 分配自定义前缀，并定义用于重复表达式查询的变量。

为默认命名空间分配一个较短的前缀、解决前缀冲突或实际定义一个前缀可能是有用的。 这可能是必不可少的，因为 XPath 不会自动匹配默认命名空间中的元素，而无需为要匹配的元素指定前缀。 编辑命名空间及其前缀和

在查询执行时，表中的每个变量可以被分配一个将被计算一次的表达式。 计算得到的值随后可供多次使用，且不增加额外的计算成本。

5. 可选：

* 选中 高亮显示结果 复选框以在当前编辑器中高亮显示匹配的节点。 不属于当前编辑器的匹配节点（可能通过使用 `document()` 函数发生）不会被高亮显示。 建议在 查找用法 工具窗口中显示此类跨文档结果。

* 选中 在使用视图中显示结果 复选框以在 查找用法 工具窗口中显示所有匹配的节点。 选中 在新选项卡中打开 复选框可在新标签页中打开结果，而不是重新使用上一个。

