# 液体

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

> **TL;DR**
> 必需插件：   液体

IntelliJ IDEA 支持 [Liquid](https://shopify.github.io/liquid/) 模板语言，并包括以下功能：

* 语法和错误高亮

* 大括号分隔符的自动闭合

* 含有 Liquid 标签（包括 [Shopify 和 Jekyll](https://shopify.github.io/liquid/basics/variations/) 标签）及过滤器的 [自动完成](auto-completing-code.html)

* [代码格式化](reformat-and-rearrange-code.html)

* 使用 `Ctrl+/` (Windows), `⌘ /` (macOS), `⌘ /` (IntelliJ IDEA Classic (macOS)), `⌘ /` (macOS System Shortcuts), `Ctrl+/` (XWin), `Ctrl+/` (GNOME), `Ctrl+/` (KDE), `Alt+;` (Emacs), `Ctrl+/` (Sublime Text), `⌘ /` (Sublime Text (macOS)), `Ctrl+Alt+/` (Visual Studio), `⌘ ⌥ /` (Visual Studio (macOS)), `Ctrl+/` (NetBeans), `Ctrl+/` (Eclipse), `⌘ /` (Eclipse (macOS)) / `Ctrl+Shift+/` (Windows), `⌘ ⌥ /` (macOS), `⌃ ⇧ /` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ /` (macOS System Shortcuts), `Ctrl+Shift+/` (XWin), `Ctrl+Shift+/` (GNOME), `Ctrl+Shift+/` (KDE), `Ctrl+Shift+/` (Emacs), `Ctrl+Shift+/` (Sublime Text), `⌘ ⌥ /` (Sublime Text (macOS)), `Ctrl+Shift+/` (Visual Studio), `⌘ ⌃ /` (Visual Studio (macOS)), `Ctrl+Shift+/` (NetBeans), `Ctrl+Shift+/` (Eclipse), `⌘ ⇧ /` (Eclipse (macOS)) 注释或取消注释行和代码块

* [代码折叠](working-with-source-code.html#code_folding)

* [代码模板](using-live-templates.html)（ 代码片段 ）

## 安装并启用 Liquid 插件

在 IntelliJ IDEA 中使用 Liquid 模板语言之前，请确保   液体   插件已经 [安装并启用](managing-plugins.html)。

## 支持的文件类型

IntelliJ IDEA 支持以下文件类型的 Liquid 语法：

* `*.liquid` 文件（作为含有 Liquid 代码的 [HTML](editing-html-files.html) 文件处理）

* `*.html.liquid` 、 `*.md.liquid` 、 `*.css.liquid` 等

如果您希望您的  `.html`  或  `.md`  文件被处理为 Liquid 文件，您可以配置 [文件类型关联](creating-and-registering-file-types.html)。 请注意，文件类型关联适用于您 IDE 中的所有项目。

Procedure: 将 HTML 文件与 Liquid 关联

1. 打开一个 HTML 文件，按 `Ctrl+Shift+A` (Windows), `⌘ ⇧ A` (macOS), `⌘ ⇧ A` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ P` (macOS System Shortcuts), `Ctrl+Shift+A` (XWin), `Ctrl+Shift+A` (GNOME), `Ctrl+Shift+A` (KDE), `Escape, X` (Emacs), `Ctrl+Shift+P` (Sublime Text), `⌘ ⇧ P` (Sublime Text (macOS)), `Ctrl+Shift+A` (Visual Studio), `⌘ ⇧ A` (Visual Studio (macOS)), `Ctrl+I` (NetBeans), `Ctrl+Shift+A` (Eclipse), `⌘ 3` (Eclipse (macOS))，然后键入   与文件类型关联  。

2. 在打开的   注册新文件类型关联证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证書证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书证书文件类型关联  窗口中，选择   Liquid 模板  。

编辑器中打开的文件现在将作为 Liquid 文件处理。

Procedure: 将所有 HTML 文件与 Liquid 关联

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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `编辑器 | 文件类型` 。

2. 从   识别的文件类型   列表中选择   Liquid 模板  。

3. 在   文件名模式   部分中，输入一个模式，例如  `*.html` 。

如果您输入的模式与现有模式匹配（例如，  `*.html`  匹配   HTML   文件类型），系统将提示您确认重新分配。

## 创建一个 Liquid 文件

要在 IntelliJ IDEA 中创建一个新的 Liquid 文件，请按照以下步骤操作：

Procedure:

1. 打开项目视图 `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS)) 并选择所需的目录。

2. 前往  `文件 | 新建 | Liquid 文件` 。 作为替代方案，请按 `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS))，然后在   新建   列表中选择   Liquid 模板语言文件  。

> **Tip:**
> 快速在   新建  列表中开始输入  Liquid File 以找到该操作。

3. 请指定文件名并按 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))。

## 实时模板

您可以使用 [实时模板](using-live-templates.html)将 Liquid 代码结构插入到您的代码中，例如  `if` 块、  `指定` 标签等。

Procedure: 展开 实时模板

要展开一个实时模板，请输入相应的模板缩写并按 `Tab` (Windows), `⇥` (macOS), `⇥` (IntelliJ IDEA Classic (macOS)), `⇥` (macOS System Shortcuts), `Tab` (XWin), `Tab` (GNOME), `Tab` (KDE), `Tab` (Emacs), `Tab` (Sublime Text), `⇥` (Sublime Text (macOS)), `Tab` (Visual Studio), `⇥` (Visual Studio (macOS)), `Tab` (NetBeans), `Tab` (Eclipse), `⇥` (Eclipse (macOS))。 下面演示如何使用预定义的  `if`  模板插入  `if`  块。

![插入 if 块，使用模板](https://resources.jetbrains.com.cn/help/img/idea/2026.3/liquid_expand_template.animated.gif)

1. 在 Liquid 文件中输入  `if` 并按下 `Tab` (Windows), `⇥` (macOS), `⇥` (IntelliJ IDEA Classic (macOS)), `⇥` (macOS System Shortcuts), `Tab` (XWin), `Tab` (GNOME), `Tab` (KDE), `Tab` (Emacs), `Tab` (Sublime Text), `⇥` (Sublime Text (macOS)), `Tab` (Visual Studio), `⇥` (Visual Studio (macOS)), `Tab` (NetBeans), `Tab` (Eclipse), `⇥` (Eclipse (macOS))。

2. 指定所需的条件，然后按 `Tab` (Windows), `⇥` (macOS), `⇥` (IntelliJ IDEA Classic (macOS)), `⇥` (macOS System Shortcuts), `Tab` (XWin), `Tab` (GNOME), `Tab` (KDE), `Tab` (Emacs), `Tab` (Sublime Text), `⇥` (Sublime Text (macOS)), `Tab` (Visual Studio), `⇥` (Visual Studio (macOS)), `Tab` (NetBeans), `Tab` (Eclipse), `⇥` (Eclipse (macOS)) 以移动到下一个语句。

3. 请输入指定条件所需的代码。

Procedure: 配置实时模板

配置 Liquid 特定的实时模板：

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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))。

2. 请转到   编辑器 | 实时代码模板   页面并在   液体   组中选择所需的模板。 您可以了解如何从 [实时模板](using-live-templates.html) 配置实时模板。

## 配置代码样式设置

要自定义 Liquid 的 [代码风格设置](configuring-code-style.html)：

Procedure:

* 按 `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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `编辑器 | 代码样式 | Liquid` 。

## 配置语法高亮

您可以根据自己的偏好和习惯配置 Liquid-aware 语法高亮显示。

Procedure:

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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))），转到  `编辑器 | 配色方案 | Liquid` 。

2. 选择配色方案，接受从默认设置继承的高亮设置，或按照 [颜色与字体](configuring-colors-and-fonts.html) 中的说明进行自定义。

