IntelliJ IDEA 2025.2 Help

Tailwind CSS

IntelliJ IDEA 集成了 Tailwind CSS ,提供 Tailwind CSS 语法支持 、Tailwind CSS 类名补全、CSS 函数和指令支持、CSS 悬停预览以及 Tailwind CSS 特定的检查功能。

IntelliJ IDEA 中的 Tailwind CSS 支持由 Tailwind CSS 语言服务器 提供支持,该服务器会检测 Tailwind CSS 包并根据其版本查找特定于 Tailwind CSS 的项目配置:

  • 使用 Tailwind CSS 4 时,语言服务器会查找包含 @import "tailwindcss" 指令的 CSS 文件。

  • 使用 Tailwind CSS 3 时,语言服务器会查找 tailwind.config.js 文件。

IntelliJ IDEA 随附了捆绑的 Tailwind CSS 语言服务器。 建议您保持语言服务器为最新版本,可通过下载最新版本并在 设置 | 语言和框架 | 样式表 | Tailwind CSS 页面上指定其路径来实现,如 配置 Tailwind CSS 语言服务器 中所述。

开始之前

  1. 请确保您的计算机上安装了 Node.js。 根据 配置本地 Node.js 解释器在 Windows Subsystem for Linux 中使用 Node.js配置远程 Node.js 解释器 中的说明,在项目中配置 Node.js 解释器。

  2. 请确保在 已安装 选项卡中的 设置 | 插件 页面启用 CSSTailwind CSS 捆绑插件,如 管理插件中所述。

  3. 请确保在 tailwindcss 中将 package.json 包列为依赖项,并通过 CSS 文件中的 @import "tailwindcss" 指令(TailwindCSS 4)或 tailwind.config.js 文件(TailwindCSS 3)正确配置了项目。

    或者,按照 如下所述 安装并配置 Tailwind CSS。

安装并配置 Tailwind CSS

请参阅 Tailwind CSS 官方网站 以获取详细说明。

  1. 打开嵌入的 终端Alt+F12 ),然后输入:

    npm install -D tailwindcss
  2. 打开要使用 Tailwind CSS 的 CSS 文件,并添加以下 import 语句:

    @import "tailwindcss";
  3. 重启 Tailwind CSS 语言服务器。 为此,请点击状态栏中的 语言服务 小组件(图标可能为 语言服务小组件语言服务小组件 ),然后点击 重启服务图标 ,位于 Tailwind CSS 旁边。

    重新启动 Tailwind CSS 服务器
  4. 打开您的 HTML 文件,并在 <head></head> 标签下添加指向 CSS 文件的链接,例如, <link href="/src/styles.css" rel="stylesheet">

配置 Tailwind CSS 语言服务器

IntelliJ IDEA 中的 Tailwind CSS 支持由 Tailwind CSS 语言服务器 提供支持,该服务器会检测 Tailwind CSS 包并根据其版本查找特定于 Tailwind CSS 的项目配置:

  • 使用 Tailwind CSS 4 时,语言服务器会查找包含 @import "tailwindcss" 指令的 CSS 文件。

  • 使用 Tailwind CSS 3 时,语言服务器会查找 tailwind.config.js 文件。

IntelliJ IDEA 随附了捆绑的 Tailwind CSS 语言服务器。 但建议您保持语言服务器为最新版本。

您还可以自定义 Tailwind CSS 的默认 配置选项

  1. 全局安装最新版本的 @tailwindcss/language-server 包。 为此,请打开内嵌的 终端Alt+F12 )并输入:

    npm install -g @tailwindcss/language-server
  2. 打开 设置 对话框(Ctrl+Alt+S )并转到 设置 | 语言和框架 | 样式表 | Tailwind&#xa0;CSS

  3. 语言服务器 字段中指定 @tailwindcss/language -server 包的路径。

  4. 可选:自定义 Tailwind CSS 的默认 配置选项。 例如,您可能希望调整 HTML 属性 列表,以提供类完成项或使用实验性的 正则表达式格式 来指定应该触发完成项的其他位置。

    配置 区域中更新属性以添加配置选项。

完成 Tailwind CSS 类

Tailwind CSS 语言服务器可在多种上下文中为 Tailwind CSS 类提供自动补全,例如 HTML 中、CSS 文件中的 @apply 指令之后、JavaScript 字符串字面量中等。 在补全列表中,来自语言服务器的建议用 Tailwind CSS 图标 标记,而 类图标 表示来自项目中已使用类的建议。

补全列表 — 来自服务器和项目的建议

预览结果 CSS

当您将鼠标悬停在 HTML 或 CSS 文件中的 Tailwind CSS 类上时,IntelliJ IDEA 会显示包含结果 CSS 预览的 文档 弹窗。 要在工具窗口中查看预览,请点击 更多图标 并选择 在文档工具窗口中显示

CSS 预览

您完成代码时,预览也会显示在 文档 弹窗 Ctrl+Q 中。

预览完成代码时生成的 CSS

在 .slim、.haml 和其他文件中的 Tailwind CSS 支持

IntelliJ IDEA 还可在其他文件类型中提供 Tailwind CSS 类补全,例如在 .slim .haml .jte .kte 等文件中。

  1. Ctrl+Alt+S 打开设置,然后选择 语言与框架 | 样式表 | Tailwind CSS

  2. includeLanguages 属性中添加需要获取 Tailwind CSS 类补全的上下文。 请使用以下格式:

    • "slim": "slim"

    • "haml": "haml"

    • "jte": "html"

    • "kte": "html"

  3. 要在 Slim 模板和 .haml 文件中启用 Tailwind CSS 类补全,请将 emmetCompletions 属性设置为 true

    添加自定义上下文用于代码补全

故障排除

如果您不再获得 Tailwind CSS 特有的编码帮助,这可能是由于以下原因之一造成的:

Tailwind CSS 语言服务器已过时

按照 上述说明 安装最新版本的 Tailwind CSS 语言服务器。

包含 @import 'tailwindcss' 的 CSS 文件已损坏
  1. 尝试注释掉除 @import "tailwindcss" 以外的所有内容,保存 CSS 文件并重启服务器。

  2. 删除注释,保存文件并一步步重启服务器,直到找到问题所在的片段。

Tailwind CSS 语言服务器未启动

发生此类错误时,状态栏中的 语言服务 小组件和 Tailwind&#xa0;CSS 项目将被标记为 错误图标

Tailwind CSS 语言服务器错误

此类错误通常由错误的 Node.js 配置引起。 要解决这个问题:

  1. Ctrl+Alt+S 打开设置,然后选择 语言和框架 | Node.js

  2. 请确保您的 Node.js 解释器路径正确。

详细了解请参见 配置 Node.js 解释器

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