# 语言注入设置对话框：通用 JavaScript

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

> **TL;DR**
> `文件 | 设置 | 编辑器 | 语言注入 - 通用 JavaScript`  适用于 Windows 和 Linux
>
>
>
> `%instance% | 设置 | 编辑器 | 语言注入 - 通用 JavaScript`  适用于 macOS
>
>
>
> `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)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) !["设置"图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.settings.svg)

当您点击 ![添加按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)并从上下文菜单中选择   通用 JS  ，或者选择一项并点击 ![“编辑”按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.edit.svg)时，将打开对话框。

|  项  |  描述  |
| --- | --- |
|  名称  |  注入的名称。  |
|  语言  |     要注入的语言。        * ID ：选择要注入的语言的 ID 或名称。    * 前缀 ：指定要在相应字符串值之前添加的字符序列。    * 后缀 ：指定要在相应字符串值之后添加的字符序列。      前缀和后缀是可选的。     |
|  位置模式  |     在此字段中，输入规则，以定义您希望 CLion 将文字识别为注入的上下文。      > **Note:** > 规则由  Program Structure Interface Patterns  构建，实际上是内部 CLion 语言的方法的链式调用。 [程序结构接口](null) 显示文件的结构，正如 CLion 处理它时一样。       例如：        inject JavaScript 到 HTML  `on*`  事件属性：       ``` xmlAttribute().withLocalName(string().startsWith("on"))  ```      通过名称以及特定父级匹配 XML 标记：       ``` xmlTag().withLocalName("script").withParent(xmlTag().withLocalName("html"))  ```       多个模式        您可以为单个注入规则定义多个位置模式。 如果任意模式匹配，则注入将被激活（它们以 OR 逻辑组合）。 每个模式请单独成行添加。      > **Warning:** > 如果正在编辑预定义的注入规则，模式已预先指定。 它们可确保高效与易用。 建议优先使用这些配置，而不是新建配置。    |
|  高级  |     在此区域，可选指定其他设置，以缩小规则适用的上下文范围，从而启用对注入过程进行更精细的控制。        * 值模式 输入用于确定 inject 语言上下文的正则表达式。 通过使用模式的第一个捕获组作为注入目标，您可以配置过程，使语言仅注入到匹配某个模式的值或匹配该模式的多个部分中。    * 单个文件 - 如果选项关闭，匹配值模式的片段会被单独处理，作为不同的“文件”——例如，从片段编辑器的视角来看。 如果该选项开启，相应的片段将全部合并在一起，形成一个单一的单元或“文件”。 鉴于此数值模式 `xxx (.+) yyy (.+) zzz` 以及片段 `xxx select * yyy from family zzz` , `select *` 和 `from family` 在选项关闭时被视为两个独立的片段（或“文件”）。 如果此选项开启， `select * from family` 会被视为单个单元或“文件”。    |

## See also

### 流程

[语言与引用注入](using-language-injections.html)

### 参考

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

