WebStorm 2025.2 Help

XPath 表达式评估

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

WebStorm 允许您以两种模式评估 XPath 表达式:

  • 简单 模式中,您可以输入无需自定义命名空间前缀的简单单行表达式。 该模式不允许配置上下文设置或使用预定义变量。

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

某些错误检查和 XPath 检查还会为检测到的问题提供快速修复,例如通过意图操作将未解析的命名空间前缀映射到 URI。

开始之前

评估 XPath 表达式

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

  2. 要切换评估模式,请单击 高级/简单 按钮。 在任一模式下,该对话框都提供最近评估表达式的历史记录、代码补全、语法检查和高亮显示,以及部分输入表达式的语义错误检查。 语义检查包括对所用命名空间前缀的验证、无效 XPath 表达式(例如, @comment() )以及针对上下文文档中不存在且无法成功匹配的元素/属性名称的节点测试。

  3. 浏览表达式历史记录的方式如下:

    • 简单 模式下,可从下拉列表中选择最近使用的表达式。

    • 高级 模式下,使用 / 或按下 Alt+Up/Alt+Down

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

    指定简短前缀、解决前缀冲突或为默认命名空间定义前缀可能很有用。 这可能至关重要,因为 XPath 不会自动匹配默认命名空间中的元素,除非为要匹配的元素指定前缀。 编辑命名空间及其前缀,并

    可以为表格中的每个变量分配一个在查询执行时会被求值一次的表达式。 所得值可多次使用,无需额外计算成本。

  5. 可选:

    • 选中 突出显示结果 复选框以在当前编辑器中高亮显示匹配的节点。 不属于当前编辑器的匹配节点(例如通过 document() 功能实现)不会被高亮显示。 建议在 查找用法 工具窗口中显示此类跨文档结果。

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

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