Tailwind CSS

PyCharm 与 Tailwind CSS 集成，提供 Tailwind CSS 语法支持、Tailwind CSS 类名补全、CSS 函数和指令的补全、悬停时预览生成的 CSS，以及特定于 Tailwind CSS 的检查。

PyCharm 中的 Tailwind CSS 支持由 Tailwind CSS 语言服务器提供。该服务器会检测 Tailwind CSS 包，并根据包的版本查找特定于 Tailwind CSS 的项目配置：

PyCharm 随附捆绑的 Tailwind CSS 语言服务器。不过，建议通过下载最新的服务器版本并在设置 | 语言 &框架 | 样式表 | Tailwind CSS 页面上指定其路径来保持语言服务器为最新，如配置 Tailwind CSS 语言服务器中所述。

在开始之前

请确保您的计算机上已安装 Node.js。按照配置本地 Node.js 解释器、在 Windows Subsystem for Linux 上使用 Node.js 或配置远程 Node.js 运行时中的说明，在项目中配置 Node.js 运行时。
请确保在设置中启用了 CSS 捆绑插件。按 Ctrl+Alt+S 打开设置，然后选择插件。点击已安装选项卡。在搜索字段中，键入 CSS。有关插件的更多信息，请参见管理插件。
按照从 JetBrains Marketplace 安装插件中的说明，在设置 | 插件页面、插件市场选项卡上安装并启用 Tailwind CSS 插件。该插件仅在 PyCharm 专业版中提供。
请确保在您的 package.json 中将 tailwindcss 包列为依赖项，并且项目已正确配置：在 CSS 文件中通过 @import "tailwindcss" 指令（TailwindCSS 4），或在 tailwind.config.js 文件中（TailwindCSS 3）。
或者，按照如下所述安装并配置 Tailwind CSS。

在 Tailwind CSS 官方网站上查找详细说明。

打开命令行 shell 或嵌入式终端（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">

PyCharm 中的 Tailwind CSS 支持由 Tailwind CSS 语言服务器提供。该服务器会检测 Tailwind CSS 包，并根据包的版本查找特定于 Tailwind CSS 的项目配置：

PyCharm 随附捆绑的 Tailwind CSS 语言服务器。不过，建议保持语言服务器为最新。

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

全局安装最新版本的 @tailwindcss/language-server 包。为此，请打开命令行 shell 或嵌入的终端（Alt+F12 ），然后输入：
npm install -g @tailwindcss/language-server
打开设置对话框（Ctrl+Alt+S ），然后转到设置 | 语言 & 框架 | 样式表 | Tailwind CSS。
在语言服务器字段中，指定 @tailwindcss/language -server 包的路径。
可选地，自定义 Tailwind CSS 的默认配置选项。例如，您可能希望调整用于提供类补全的 HTML 属性列表，或使用实验性的正则表达式格式来指定应触发补全的其他位置。
在配置区域，更新属性以添加配置选项。

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

当您在 HTML 或 CSS 文件中将鼠标悬停在 Tailwind CSS 类上时，PyCharm 会显示文档注释弹出窗口，预览生成的 CSS。要在工具窗口中查看预览，请点击并选择在文档工具窗口中显示。

在进行代码补全时，预览也会显示在文档注释弹出窗口（Ctrl+Q ）中。

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

按下 Ctrl+Alt+S 以打开设置，然后选择语言 & 框架 | 样式表 | Tailwind CSS。
在 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 语言服务器无法启动

发生此类错误时，状态栏中的语言服务小部件和 Tailwind CSS 项会标记为。

大多数情况下，此类错误是由不正确的 Node.js 配置引起的。要解决此问题：

在配置 Node.js 解释器中了解详细信息。

2026年 7月 14日