# Tailwind CSS

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

> **TL;DR**
> 必需插件:
>
>
>
> `CSS` 、  `Tailwind CSS` ：这些插件与 CLion 一起捆绑，并默认启用。

CLion 集成了 [Tailwind CSS](https://tailwindcss.com)，提供 [Tailwind&#xa0;CSS 语法支持](https://tailwindcss.com/docs/editor-setup)、Tailwind CSS 类名的补全、CSS 函数和指令的补全、悬停时预览生成的 CSS，以及 Tailwind CSS 特定的检查功能。

CLion 中的 Tailwind CSS 支持由 [Tailwind&#xa0;CSS 语言服务器](https://www.npmjs.com/package/@tailwindcss/language-server) 提供支持，该服务器会检测 Tailwind CSS 包，并根据包的版本搜索 Tailwind CSS 特定的项目配置：

* 对于 Tailwind CSS 4，语言服务器会查找包含 `@import "tailwindcss"` 指令的 CSS 文件。

* 对于 Tailwind CSS 3，语言服务器会查找 `tailwind.config.js` 文件。

CLion 附带了一个捆绑的 Tailwind CSS 语言服务器。 然而，建议您通过下载最新的服务器版本并在  `设置 | 语言与框架 | 样式表 | Tailwind CSS`  页面中指定路径（如 [配置 Tailwind CSS 语言服务器](#ws_tailwind_configure_language_server) 中所述）来保持语言服务器的最新状态。

## 在开始之前

Procedure:

1. 请确保您的计算机上安装了 [Node.js](http://nodejs.org/)。 请按照 [配置本地 Node.js 解释器](developing-node-js-applications.html#ws_node_configure_local_node_interpreter)、 [在 Windows Subsystem for Linux 上使用 Node.js](developing-node-js-applications.html#ws_node_wsl) 或 [配置远程 Node.js 运行时](null) 中所述，在项目中配置 Node.js 运行时。

2. 请确保在   设置 | 插件  页面上启用了   CSS  和   Tailwind CSS  捆绑插件，如 [管理插件](managing-plugins.html)中所述。

3. 确保  `tailwindcss`  包已列为  `package.json`  的依赖项，并通过 CSS 文件中的  `@import "tailwindcss"`  指令（TailwindCSS 4）或  `tailwind.config.js`  文件（TailwindCSS 3）正确配置了项目。

或者，按照 [如下所述](#ws_css_tailwind_install_configure) 安装并配置 Tailwind CSS。

## 安装并配置 Tailwind CSS

在 [Tailwind CSS 官方网站](https://tailwindcss.com/docs/installatione) 上查找详细说明。

Procedure:

1. 打开命令行 shell 或嵌入式   终端  （ `Alt+F12` (Windows), `⌥ F12` (macOS), `⌥ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ T` (macOS System Shortcuts), `Alt+F12` (XWin), `Alt+F12` (GNOME), `Alt+F12` (KDE), `Alt+F12` (Emacs), `Alt+F12` (Sublime Text), `⌥ F12` (Sublime Text (macOS)), `⌥ F12` (Xcode), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Ctrl+Alt+1` (ReSharper), `⌘ ⌃ 1` (ReSharper (macOS)), `Alt+F12` (QtCreator), `⌥ F12` (QtCreator (macOS)), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS))），然后输入：

```SHELL
npm install -D tailwindcss
                        
```

2. 打开您希望使用 Tailwind CSS 的 CSS 文件，并向其中添加以下  `import`  语句：

```CSS
@import "tailwindcss";

```

3. 重启 Tailwind CSS 语言服务器。 为此，请单击状态栏中的   语言服务   小部件（图标为 ![语言服务小部件](https://resources.jetbrains.com/help/img/idea/2026.3/icon_tailwind_ls_server_status_bar.png) 或 ![语言服务小部件](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.json.object.svg)），然后单击 ![重启服务图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.stopAndRestart.svg)，位于   Tailwind CSS   旁边。

![重新启动 Tailwind CSS 服务器](https://resources.jetbrains.com/help/img/idea/2026.3/styles.css" rel="stylesheet">`

### 配置 Tailwind CSS 语言服务器

CLion 中的 Tailwind CSS 支持由 [Tailwind&#xa0;CSS 语言服务器](https://www.npmjs.com/package/@tailwindcss/language-server) 提供支持，该服务器会检测 Tailwind CSS 包，并根据包的版本搜索 Tailwind CSS 特定的项目配置：

* 对于 Tailwind CSS 4，语言服务器会查找包含 `@import "tailwindcss"` 指令的 CSS 文件。

* 对于 Tailwind CSS 3，语言服务器会查找 `tailwind.config.js` 文件。

CLion 附带了一个捆绑的 Tailwind CSS 语言服务器。 然而，建议您保持语言服务器的最新状态。

您还可以自定义 Tailwind CSS 的默认 [配置选项](#ws_css_tailwind_configuration_customize_options)。

Procedure:

1. 全局安装最新版本的 [@tailwindcss/language-server 包](https://www.npmjs.com/package/@tailwindcss/language-server)。 为此，打开命令行 shell 或嵌入式   终端  （ `Alt+F12` (Windows), `⌥ F12` (macOS), `⌥ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ T` (macOS System Shortcuts), `Alt+F12` (XWin), `Alt+F12` (GNOME), `Alt+F12` (KDE), `Alt+F12` (Emacs), `Alt+F12` (Sublime Text), `⌥ F12` (Sublime Text (macOS)), `⌥ F12` (Xcode), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Ctrl+Alt+1` (ReSharper), `⌘ ⌃ 1` (ReSharper (macOS)), `Alt+F12` (QtCreator), `⌥ F12` (QtCreator (macOS)), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS))），然后输入：

```SHELL
npm install -g @tailwindcss/language-server

```

2. 打开   设置  对话框（ `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))），然后转到  `设置 | 语言与框架 | 样式表 | Tailwind CSS` 。

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

4. 可选：自定义 Tailwind CSS 的默认 [配置选项](https://github.com/tailwindlabs/tailwindcss-intellisense#extension-settings)。 例如，您可能希望调整 [HTML 属性](https://github.com/tailwindlabs/tailwindcss-intellisense#tailwindcssclassattributes) 列表，以提供类完成项或使用实验性的 [正则表达式格式](https://github.com/tailwindlabs/tailwindcss/issues/7553#issuecomment-735915659) 来指定应该触发完成项的其他位置。

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

## 完成 Tailwind CSS 类

Tailwind CSS 语言服务器在各种上下文中提供 Tailwind CSS 类的自动补全，例如，在 HTML 和 CSS 文件中包含  `@apply`  指令后，在 JavaScript 字符串字面量中等。 在补全列表中，来自语言服务器的建议标记为 ![Tailwind CSS 图标](https://resources.jetbrains.com/help/img/idea/2026.3/icon_tailwind.png)，而 ![类图标](https://resources.jetbrains.com/help/img/idea/2026.3/icon_completion_list_class.png) 表示来自项目中已使用类的建议。

![补全列表 — 来自服务器和项目的建议](https://resources.jetbrains.com/help/img/idea/2026.3/ws_tailwind_completion_tw_classes_and_used_classes.png)

### 预览结果 CSS

当您将鼠标悬停在 HTML 或 CSS 文件中的 Tailwind CSS 类上时，CLion 会显示一个   文档   弹出窗口，预览生成的 CSS。 要在工具窗口中查看预览，请点击 ![更多图标](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.moreVertical.svg)并选择   在文档工具窗口中显示  。

![CSS 预览](https://resources.jetbrains.com/help/img/idea/2026.3/ws_tailwind_css_preview.png)

您完成代码时，预览也会显示在   文档  弹窗 `Ctrl+Q` (Windows), `F1` (macOS), `⌃ J` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Ctrl+Q` (XWin), `Ctrl+Q` (GNOME), `Ctrl+Q` (KDE), `Ctrl+Q` (Emacs), `Ctrl+Q` (Sublime Text), `Ctrl+Q` (Sublime Text (macOS)), `⌘ ⌃ ⇧ /` (Xcode), `Ctrl+K, I` (Visual Studio), `⌘ K, I` (Visual Studio (macOS)), `Ctrl+Q` (ReSharper), `⌃ Q` (ReSharper (macOS)), `Ctrl+Q` (QtCreator), `Ctrl+Q` (QtCreator (macOS)), `Ctrl+Q` (NetBeans), `Alt+Middle-Click` (Eclipse), `⌥ Middle-Click` (Eclipse (macOS))中。

![预览完成代码时生成的 CSS](https://resources.jetbrains.com/help/img/idea/2026.3/ws_tailwind_css_preview_completion.png)

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

CLion 可以在其他文件类型中提供 Tailwind CSS 类的补全，例如，在  `.slim` 、  `.haml` 、  `.jte` 、  `.kte`  等文件中。

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)), `⌘ 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)) 打开设置，然后选择  `语言与框架 | 样式表 | Tailwind CSS` 。

2. 在  `includeLanguages`  属性中，添加您希望获得 Tailwind CSS 类补全的上下文。 请使用以下格式：

* `"slim": "slim"`

* `"haml": "haml"`

* `"jte": "html"`

* `"kte": "html"`

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

![添加自定义上下文用于代码补全](https://resources.jetbrains.com/help/img/idea/2026.3/ws_css_tailwind_custom_contexts_settings.png)

## 故障排查

如果您停止获得 Tailwind CSS 特定的编码辅助，可能是以下原因之一导致的：

Tailwind CSS 语言服务器已过时
: 按照 [上述说明](#ws_tailwind_configure_language_server) 安装最新版本的 Tailwind CSS 语言服务器。

包含 @import 'tailwindcss' 的 CSS 文件已损坏
: > **Note:**
: > 适用于使用 Tailwind CSS 4 及以上版本的项目。
:
:
:
: 如果带有 @import 'tailwindcss' 的 CSS 文件已损坏，可能会导致服务器初始化失败。 在这种情况下，状态栏上显示一个错误指示器 ![错误图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.testError.svg)，并且在   Tailwind CSS   项目旁边也会显示。
:
:
:
: ![状态栏上显示一个错误指示器](https://resources.jetbrains.com/help/img/idea/2026.3/tailwind_css_troubleshooting_list_css_file_corrupted.png)
:
: 要解决该问题：
:
:
:
: 1.
:
: 尝试注释掉除  `@import "tailwindcss"`  之外的所有内容，保存 CSS 文件并重启服务器。
:
:
:
: 2.
:
: 逐步删除注释，保存文件并重启服务器，直到找到问题所在的片段。
:
:
:
: > **Note:**
: > 要重启服务器，请使用状态栏中的   语言服务   小部件， [如上所述](#ws_css_tailwind_restart_server)。

Tailwind CSS 语言服务器未启动
: 当发生此类错误时，状态栏中的   语言服务   小部件和   Tailwind CSS   项目会标记为 ![错误图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.testError.svg)。
:
:
:
: ![Tailwind CSS 语言服务器错误](https://resources.jetbrains.com/help/img/idea/2026.3/ws_css_tailwind_server_error.png)
:
: 此类错误通常是由于 Node.js 配置不正确引起的。 要解决这个问题：
:
:
:
: 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)) 打开设置，然后选择  `语言&框架 | JavaScript 运行时` 。
:
:
:
: 2.
:
: 请确保在   Node.js   字段中选择了   首选运行时  。
:
:
:
: 3.
:
: 请确保您的 Node.js 运行时的路径正确。
:
:
:
:
:
: 详细了解请参见 [配置 Node.js 解释器](developing-node-js-applications.html#ws_node_configure_local_node_interpreter)。

