# 语言注入设置对话框：XML 标签注入

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

> **TL;DR**
> `文件 | 设置 | 编辑器 | 语言注入 |`  !["添加"按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)  `| XML 标签注入`  适用于 Windows 和 Linux
>
>
>
> `%instance% | 设置 | 编辑器 | 语言注入 |`  !["添加"按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)  `| XML 标签注入`  适用于 macOS

|  条目  |  描述  |
| --- | --- |
|  名称  |  注入的名称。  |
|  语言  |     要注入的语言。        * ID : 选择要 inject 的语言的 ID 或名称。    * 前缀 : 指定要添加到相应字符串值之前的字符序列。    * 后缀 : 指定要添加到相应字符串值之后的字符序列。      前缀和后缀是可选的。     |
|  XML 标记  |     在此区域中，定义 XML 标签，该标签指示此标签中包含的文本应被视为所选语言。        * 本地名称 ：指定不带命名空间前缀的标记名称。 使用正则表达式指定多个标记名称 `name1\|name2` 、不区分大小写的名称（ `(?i)tagname` 会同时匹配 tagname 和 TagName ），等等。 > **Warning:** > 请务必不要输入任何空格字符，因为它们对匹配来说非常重要。    * 命名空间 ：指定 XML 标签的命名空间 URI。 该字段是可选的。    |
|  子标签  |  选择此复选框可递归地包含所有子标签。  |
|  高级  |     指定其他设置，以实现对注入过程的更精细控制。        * 值模式 - 在此字段中，在 值模式 字段中，输入一个正则表达式，用于确定要将语言注入到的上下文。 通过将模式的第一个捕获组用作受限标识符的目标，可以配置该过程，使语言仅被 inject 到匹配特定模式的值中，或被 inject 到匹配该模式的多个部分中。 示例 ： `[$#]\{(.*?)\}` 匹配 JSP/JSF 表达式语言所使用的模式。 `^javascript:(.*)` 匹配可用于执行 JavaScript 代码的超链接 href 中的 `javascript` 协议。 * 单个文件 - 如果此选项关闭，与值模式匹配的片段将被单独处理，视为不同的“文件”——例如，从片段编辑器的视角来看。 如果该选项开启，相应片段会全部合并在一起，形成一个单元或“文件”。 给定值模式 `xxx (.+) yyy (.+) zzz` 以及片段 `xxx select * yyy from family zzz` ， 如果该选项关闭， `select *` 和 `from family` 会被视为两个独立片段（或“文件”）。 如果该选项开启， `select * from family` 会被视为一个单元或“文件”。    * XPath 条件 ：更精确地指定注入目标的 XPath 表达式。 表达式被求值的上下文是周围的 XML 标签。 如有需要，请使用 XPath [扩展程序函数／方法](http://www.cafeconleche.org/jaxen/apidocs/org/jaxen/function/ext/package-summary.html)，例如， `lower-case()` 。 此外，还有三个附加函数可以用来确定当前文件的名称、扩展名和文件类型： `file-name()` 、 `file-ext()` 和 `file-type()` 。 或者，您也可以通过标准代码补全来获取可用函数列表。 > **Note:** > 要使该字段处于活动状态，请确保已启用 XPathView + XSLT Support [插件](managing-plugins.html)。 > **Warning:** > 出于性能原因，建议您尽量保持这些表达式的简单性。 特别是会导致整个文档被扫描的表达式，例如 `//foo/bar` ，可能会导致大文件的性能问题。    |

## 运作方式

* [语言和引用受限标识符](using-language-injections.html)

## See also

### 过程

[语言和引用受限标识符](using-language-injections.html)

### 参考

[正则表达式语法参考](regular-expressions.html)

