# 语言与引用注入

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

语言注入使您可以处理与文件主语言不同的编程语言的代码片段。

当您将一种语言（如 HTML、CSS、XML、RegExp 等）注入字符串字面量时，即使它不是您的项目的主要语言，您也可以获得针对注入代码的全面编码支持。

除了语言注入之外，IDE 还支持引用注入，其会将字符串文字视为对其他实体（例如类或文件）的引用。

## 添加语言注入

Procedure: 添加持久性语言注入

使用语言注入注释（annotation）来添加语言注入的持久性片段。

* 在目标字符串文本前添加一个空行，并输入以下注释：

```SHELL
// language=<language_ID>

```

请使用添加注释所在文件的注释语法编写注释，而不是要 inject 的语言的注释语法。 语言 ID 可能不同于 CLion 显示的语言名称，例如在可注入语言列表中显示的语言名称。

要查找语言 ID，请在注释中将文本光标放在  `language=`  之后，然后按 `Ctrl+Space` (Windows), `⌃ Space` (macOS), `⌃ Space` (IntelliJ IDEA Classic (macOS)), `⌃ Space` (macOS System Shortcuts), `Ctrl+Space` (XWin), `Ctrl+Space` (GNOME), `Ctrl+Space` (KDE), `Alt+/` (Emacs), `Ctrl+Space` (Sublime Text), `⌃ Space` (Sublime Text (macOS)), `⌃ Space` (Xcode), `Ctrl+Space` (Visual Studio), `⌃ Space` (Visual Studio (macOS)), `Ctrl+Space` (ReSharper), `⌃ Space` (ReSharper (macOS)), `Ctrl+Space` (QtCreator), `⌃ Space` (QtCreator (macOS)), `Ctrl+Space` (NetBeans), `Ctrl+Space` (Eclipse), `⌃ Space` (Eclipse (macOS))。 补全列表会显示所有可注入语言的 ID，并在圆括号中显示语言名称。

您还可以在设置中了解 language ID。 按下 `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)) 打开设置，然后选择  `Editor | Language Injections` 。 双击某语言的注入规则；语言 ID 已指定在   ID   字段。

* （可选）在注释中包含前缀或后缀。

```SHELL
// language=<language_ID> prefix=<prefix> suffix=<suffix>
```

在以下情况下需要：

* 字符串是一个不完整或部分的 SQL 语句

* 该字符串未直接用于我们支持的调用之一（例如 `select /where)`

## 编辑注入的语言片段

CLion 允许您在专用编辑器中编辑注入的语言片段。

Procedure: 打开片段编辑器

1. 将插入符置于注入的代码片段内，然后按 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `⌥ ⏎` (Xcode), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (ReSharper), `⌥ ⏎` (ReSharper (macOS)), `Alt+Enter` (QtCreator), `⌥ ⏎` (QtCreator (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS))（或使用 意图操作 图标 ![意图操作图标](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.codeInsight.intentionBulb.svg)）。

2. 请选择   编辑 <language ID> 片段  。

CLion 将会打开一个专门的编辑区来编辑注入的语言代码。 此编辑器提供完整的编码辅助功能，包括代码补全、检查、 意图操作s 和代码风格操作。

> **Note:**
> 在编辑代码时，您只能在片段编辑器中看到前缀和后缀。 它们不会显示在主编辑器中。

## 注入引用

引用注入将字符串字面量解释为指向其他实体（例如文件）的链接。

例如，  `resources/config.json`  可被视为对文件的引用。

Procedure: 添加临时引用注入

1. 将插入符置于您要注入引用的字符串字面量内，然后按 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `⌥ ⏎` (Xcode), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (ReSharper), `⌥ ⏎` (ReSharper (macOS)), `Alt+Enter` (QtCreator), `⌥ ⏎` (QtCreator (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS))（或使用 意图操作 图标 ![意图操作图标](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.codeInsight.intentionBulb.svg)）。

2. 选择   注入语言或引用  ，然后选择一个选项，例如：

* 文件引用 ：向指定文件添加引用。

根据您安装的插件，可能还会提供其他引用选项。

Procedure: 添加持久引用注入

使用注释添加持久引用注入。

* 在目标字符串字面量之前添加一个空行，并输入带有所需值的  `// language=`  注释。

* `// language=file-reference` 会向文件添加引用。

## 取消注入

Procedure: 取消持久性语言注入

要取消语言注入，请删除用于引入该语言注入的注释（annotation）。

Procedure: 取消临时语言注入

1. 将插入符置于该代码片段处，然后按 `Alt+Enter` (Windows), `⌥ ⏎` (macOS), `⌥ ⏎` (IntelliJ IDEA Classic (macOS)), `⌥ ⏎` (macOS System Shortcuts), `Alt+Enter` (XWin), `Alt+Enter` (GNOME), `Alt+Enter` (KDE), `Alt+Enter` (Emacs), `Alt+Enter` (Sublime Text), `⌥ ⏎` (Sublime Text (macOS)), `⌥ ⏎` (Xcode), `Alt+Enter` (Visual Studio), `⌥ ⏎` (Visual Studio (macOS)), `Alt+Enter` (ReSharper), `⌥ ⏎` (ReSharper (macOS)), `Alt+Enter` (QtCreator), `⌥ ⏎` (QtCreator (macOS)), `Alt+Enter` (NetBeans), `Ctrl+1` (Eclipse), `⌘ 1` (Eclipse (macOS))（或使用 意图操作 图标 ![意图操作按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.codeInsight.intentionBulb.svg)）。

2. 请选择   取消注入语言或引用  。

Procedure: 禁用意图操作灯泡图标

执行以下操作以隐藏编辑器中的意图操作图标 ![意图操作图标](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.codeInsight.intentionBulb.svg)：

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)), `⌘ 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)) 打开设置，然后选择  `编辑器｜常规｜外观` 。

2. 清除   显示意图灯泡  复选框。

3. 应用更改并关闭对话框。

## 配置自动注入规则

在 CLion 中，有一组预定义规则，根据这些规则，IDE 会在您的代码中的某些位置自动注入语言。

您可以在   Editor | Language Injections   设置页面 `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)) 配置语言注入规则。

所有预定义的注入规则均为   内置   作用域配置。 换句话说，它们是全局的（因此在所有 CLion 项目中都可用）。 您可以为 IDE 或仅为一个项目配置自定义规则。 要更改自定义注入作用域，请使用 ![“移动到 Project / IDE 作用域”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.import.svg)。

要通过 VCS 共享自定义规则，请使用工具栏上的相应选项将其移动到   项目  作用域。 通过这样做，您将在  `.idea`  目录中创建一个名为  `IntelliLang.xml`  的新文件，其中包含您可以置于版本控制下的自定义规则。

如果不使用 VCS，可以通过将规则导出到 XML 文件(点击工具栏上的 ![导出](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.export.svg))，然后将其导入另一个项目来共享规则。

要配置自定义注入规则，请点击 ![添加按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)以添加新规则，或复制预定义规则并更改其设置。

## See also

### 参考

[语言注入](language-injections-settings.html)

