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 语言服务器 中所述。
开始之前
请确保您的计算机上安装了 Node.js。 根据 配置本地 Node.js 解释器、 在 Windows Subsystem for Linux 中使用 Node.js 或 配置远程 Node.js 解释器 中的说明,在项目中配置 Node.js 解释器。
请确保在 已安装 选项卡中的 设置 | 插件 页面启用 CSS 和 Tailwind CSS 捆绑插件,如 管理插件中所述。
请确保在
tailwindcss中将 package.json 包列为依赖项,并通过 CSS 文件中的@import "tailwindcss"指令(TailwindCSS 4)或 tailwind.config.js 文件(TailwindCSS 3)正确配置了项目。或者,按照 如下所述 安装并配置 Tailwind CSS。
安装并配置 Tailwind CSS
请参阅 Tailwind CSS 官方网站 以获取详细说明。
打开嵌入的 终端 (Alt+F12 ),然后输入:
npm install -D tailwindcss打开要使用 Tailwind CSS 的 CSS 文件,并添加以下
import语句:@import "tailwindcss";重启 Tailwind CSS 语言服务器。 为此,请点击状态栏中的 语言服务 小组件(图标可能为
或 ),然后点击
,位于 Tailwind CSS 旁边。

打开您的 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 的默认 配置选项。
全局安装最新版本的 @tailwindcss/language-server 包。 为此,请打开内嵌的 终端 (Alt+F12 )并输入:
npm install -g @tailwindcss/language-server打开 设置 对话框(Ctrl+Alt+S )并转到 。
在 语言服务器 字段中指定
@tailwindcss/language -server包的路径。可选:自定义 Tailwind CSS 的默认 配置选项。 例如,您可能希望调整 HTML 属性 列表,以提供类完成项或使用实验性的 正则表达式格式 来指定应该触发完成项的其他位置。
在 配置 区域中更新属性以添加配置选项。
完成 Tailwind CSS 类
Tailwind CSS 语言服务器可在多种上下文中为 Tailwind CSS 类提供自动补全,例如 HTML 中、CSS 文件中的 @apply 指令之后、JavaScript 字符串字面量中等。 在补全列表中,来自语言服务器的建议用
标记,而
表示来自项目中已使用类的建议。

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

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

在 .slim、.haml 和其他文件中的 Tailwind CSS 支持
IntelliJ IDEA 还可在其他文件类型中提供 Tailwind CSS 类补全,例如在 .slim 、 .haml 、 .jte 、 .kte 等文件中。
按 Ctrl+Alt+S 打开设置,然后选择 。
在
includeLanguages属性中添加需要获取 Tailwind CSS 类补全的上下文。 请使用以下格式:"slim": "slim""haml": "haml""jte": "html""kte": "html"
要在 Slim 模板和 .haml 文件中启用 Tailwind CSS 类补全,请将
emmetCompletions属性设置为true。
故障排除
如果您不再获得 Tailwind CSS 特有的编码帮助,这可能是由于以下原因之一造成的:
- Tailwind CSS 语言服务器已过时
按照 上述说明 安装最新版本的 Tailwind CSS 语言服务器。
- 包含 @import 'tailwindcss' 的 CSS 文件已损坏
尝试注释掉除
@import "tailwindcss"以外的所有内容,保存 CSS 文件并重启服务器。删除注释,保存文件并一步步重启服务器,直到找到问题所在的片段。
- Tailwind CSS 语言服务器未启动
发生此类错误时,状态栏中的 语言服务 小组件和 Tailwind CSS 项目将被标记为
。

此类错误通常由错误的 Node.js 配置引起。 要解决这个问题:
按 Ctrl+Alt+S 打开设置,然后选择 。
请确保您的 Node.js 解释器路径正确。
详细了解请参见 配置 Node.js 解释器。