WebStorm 2025.2 Help

Liquid

WebStorm 支持 Liquid 模板语言,并具备以下功能:

安装并启用 Liquid 插件

在 WebStorm 中使用 Liquid 模板语言前,请确保插件 Liquid安装并启用

支持的文件类型

WebStorm 支持以下文件类型的 Liquid 语法:

  • *.liquid 文件(作为包含 Liquid 代码的 HTML 文件处理)

  • *.html.liquid *.md.liquid *.css.liquid

如果希望将 .html .md 文件作为 Liquid 文件处理,您可以配置 文件类型关联。 请注意,文件类型关联适用于您 IDE 中的所有项目。

将 HTML 文件关联为 Liquid

  1. 打开 HTML 文件,按 Ctrl+Shift+A ,然后输入 关联到文件类型

  2. 在打开的 注册新文件类型关联 窗口中,选择 Liquid 模板

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

将所有 HTML 文件关联为 Liquid

  1. Ctrl+Alt+S 打开设置,然后选择 编辑器 | 文件类型

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

  3. 文件名模式 部分中,输入模式,例如 *.html

    如果输入的模式与已有模式匹配(例如, *.html 匹配 HTML 文件类型),系统会提示您确认重新分配。

创建 Liquid 文件

要在 WebStorm 中创建新的 Liquid 文件,请按以下步骤操作:

  1. 打开项目视图 Alt+1 并选择目标目录。

  2. 转到 文件 | 新建 | Liquid 文件。 或者,按 Alt+Insert ,然后在 新建 列表中选择 Liquid 文件

  3. 指定文件名后,按 Enter

实时模板

您可以使用 实时模板 将 Liquid 代码结构插入到代码中,例如 if 块、 assign 标签等。

展开实时模板

要展开实时模板,请输入对应的模板缩写并按 Tab。 下面演示如何使用预定义的 if 模板插入 if 块。

使用模板插入 if 代码块
  1. 在 Liquid 文件中输入 if 并按 Tab

  2. 指定所需条件后,按 Tab 跳转到下一个语句。

  3. 输入满足指定条件的期望代码。

配置实时模板

要配置 Liquid 特定的实时模板:

  1. 打开 设置 Ctrl+Alt+S

  2. 转到 编辑器 | 代码模板 页面,在 Liquid 分组中选择所需模板。 您可以从 实时模板 了解如何配置实时模板。

配置代码样式设置

要自定义 Liquid 的 代码样式设置

  • Ctrl+Alt+S 打开设置,然后选择 编辑器 | 代码样式 | Liquid

配置语法高亮

您可以根据自身喜好配置 Liquid 感知的语法高亮方式。

  1. 设置 对话框(Ctrl+Alt+S )中,转到 编辑器 | 配色方案 | Liquid

  2. 选择配色方案,接受默认继承的高亮设置或根据 颜色和字体 中所述进行自定义。

最后修改日期: 2025年 9月 26日