PyCharm 2026.1 Help

语言注入设置对话框: XML 属性注入

项目

描述

名称

注入名称。

语言

要注入的语言。

  • ID :选择要注入的语言的 ID 或名称。

  • 前缀 :指定在相应字符串值之前添加的字符序列。

  • 后缀 :指定在相应字符串值之后添加的字符序列。

前缀和后缀为可选。

XML 标记

在此区域,指定受定义规则影响的 XML 标记内的属性。

  • 本地名称 字段中,指定不带命名空间前缀的标记名称。 使用正则表达式指定多个标签名称 name1|name2 、不区分大小写的名称((?i)tagname 可同时匹配 tagnameTagName )等。

  • 命名空间 字段中,指定 XML 标记的命名空间 URI。

这两个字段均为可选项。 但是,如果 本地名称 字段为空,则配置将应用于任何与已配置名称匹配的属性,而不考虑其所属的 XML 标记。

XML 属性

在此区域中,定义 XML 标记属性,用于指示具有此类属性的标记中包含的文本应按所选语言处理。

  • 本地名称 :指定不带命名空间前缀的属性名称。 使用正则表达式:例如,要匹配 HTML 事件处理程序属性,请在该字段中键入 on.*

    除非 本地名称 区域中的 XML 标记 字段为空,否则此字段为可选项。 如果未指定属性的本地名称,配置将应用于封闭标记的所有属性。

  • 命名空间 :指定该属性的命名空间 URI。

高级

在此区域中,指定附加设置,以便更精细地控制注入过程。

  • 值模式 - 在此字段中,输入一个正则表达式,用于确定注入语言的上下文。 通过使用模式的第一个捕获组作为注入目标,您可以将过程配置为仅将语言注入到匹配特定模式的值中,或注入到匹配该模式的多个部分中。

  • 单个文件 - 如果此选项关闭,与值模式匹配的片段将被单独处理,视为不同的“文件”——例如,从片段编辑器的视角来看。

    如果该选项开启,相应片段将合并为一个整体或"文件"。

    给定的值模式

    xxx (.+) yyy (.+) zzz

    以及片段

    xxx select * yyy from family zzz

    select *from family 在选项关闭时将被视为两个独立的片段(或"文件")。 如果该选项开启, select * from family 将被视为一个整体或"文件"。

  • XPath 条件 - 在此字段中,指定一个 XPath 表达式以更准确地定位注入目标。 表达式所评估的上下文为 XML 属性本身。

    如有需要,请使用 XPath 扩展函数 ,例如, lower-case()。 此外,还有三个附加函数可用于确定当前文件的名称、扩展名和文件类型: file-name()file-ext()file-type()。 或者,您可以通过标准代码补全获取可用函数列表。

2026年 3月 24日