PhpStorm 2026.3 Help

Tailwind CSS

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

PhpStorm 中的 Tailwind CSS 支持由 Tailwind CSS 语言服务器 提供支持,该服务器会检测 Tailwind CSS 软件包,并根据软件包的版本搜索 Tailwind CSS 特定的项目配置:

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

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

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

开始之前

  1. 请确保您的计算机上安装了 Node.js。 请按照 配置本地 Node.js 解释器、 在 Windows Subsystem for Linux 上使用 Node.js 或 配置远程 Node.js 运行时 中所述,在项目中配置 Node.js 运行时。

  2. 请确保在 设置 | 插件 页面上启用了 CSS 和 Tailwind CSS 捆绑插件,如 管理插件中所述。

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

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

安装并配置 Tailwind CSS

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

  1. 打开命令行 shell 或嵌入式 终端 (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 语言服务器

PhpStorm 中的 Tailwind CSS 支持由 Tailwind CSS 语言服务器 提供支持,该服务器会检测 Tailwind CSS 软件包,并根据软件包的版本搜索 Tailwind CSS 特定的项目配置:

  • 在 Tailwind&#xa0;CSS&#xa0;4 中,语言服务器会查找包含 @import "tailwindcss" 指令的 CSS 文件。

  • 在 Tailwind&#xa0;CSS&#xa0;3 中,语言服务器会查找 tailwind.config.js 文件。

PhpStorm 随附捆绑的 Tailwind&#xa0;CSS 语言服务器。 但是,建议使语言服务器保持最新。

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

  1. 全局安装最新版本的 @tailwindcss/language-server 包。 为此,请打开命令行 shell 或嵌入式 终端 (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&#xa0;CSS 类上时,PhpStorm 会显示一个 文档 弹出窗口,其中包含生成的 CSS 预览。 要在工具窗口中查看预览,请点击 更多图标 并选择 在文档工具窗口中显示。

CSS 预览

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

预览完成代码时生成的 CSS

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

PhpStorm 可以在其他文件类型中为 Tailwind&#xa0;CSS 类提供补全,例如在 .slim 、 .haml 、 .jte 、 .kte 等中。

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

  2. 在 includeLanguages 属性中,添加希望获取 Tailwind&#xa0;CSS 类补全的上下文。 请使用以下格式:

    • "slim": "slim"

    • "haml": "haml"

    • "jte": "html"

    • "kte": "html"

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

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

故障排查

如果不再获得 Tailwind CSS 专属的编码辅助,可能是由于以下原因之一:

Tailwind CSS 语言服务器已过时

安装最新版本的 Tailwind CSS 语言服务器 如上所述。

包含 @import 'tailwindcss' 的 CSS 文件已损坏

如果包含 @import 'tailwindcss' 的 CSS 文件已损坏,可能会破坏服务器初始化。 在这种情况下,错误指示器 错误图标。 会显示在状态栏上,也会显示在 Tailwind&#xa0;CSS 项旁边。

状态栏上显示错误指示器

要解决此问题:

  1. 尝试注释掉 @import "tailwindcss" 以外的所有内容,保存 CSS 文件,然后重启服务器。

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

Tailwind CSS 语言服务器未启动

发生此类错误时,状态栏中的 语言服务 微件和 Tailwind&#xa0;CSS 项会标记为 错误图标。。

Tailwind CSS 语言服务器错误

大多数情况下,此类错误是由不正确的 Node.js 配置导致的。 要解决这个问题:

  1. 按 Ctrl+Alt+S 打开设置,然后选择 语言&框架 | JavaScript 运行时。

  2. 请确保在 Node.js 字段中选择了 首选运行时。

  3. 请确保您的 Node.js 运行时的路径正确。

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

2026年 11月 9日