WebStorm 的 Tailwind 智能提示需同时满足五点:正确识别 tailwind.config.cjs(仅支持 CommonJS)、PostCSS 7 + Tailwind 2.1.4 兼容组合、关闭节电模式、重启语言服务、postcss.config.cjs 中 plugins 为对象字面量。

WebStorm 的 Tailwind 智能提示不会自动生效,必须同时满足:配置文件被正确识别、PostCSS 版本兼容、节电模式关闭、语言服务重启——缺一不可,且最容易卡在 tailwind.config.js 加载失败或 Power Save Mode 开启上。
tailwind.config.cjs 必须用 CommonJS 导出
WebStorm(截至 2026 年 5 月)不解析 ES 模块语法或 TypeScript 配置文件。哪怕你用 tailwind.config.ts 或 export default 写法,IDE 都会静默跳过。
- 删掉
tailwind.config.js或tailwind.config.ts,新建tailwind.config.cjs - 内容必须是
module.exports = { content: [...] },不能是export default -
content字段必须覆盖所有模板路径:Vue 项目要写.{vue,js,ts,jsx,tsx},React 项目漏掉jsx或tsx就会导致对应文件无补全 - 右键该文件 → Reload project,或菜单栏
File → Reload project from disk强制重载配置
postcss.config.cjs 插件必须写成对象字面量
WebStorm 的 Tailwind 语言服务不执行 require(),只认 plugins 字段里的对象声明。写成 require('tailwindcss') 能跑构建,但 IDE 提示直接失效。
- 把
postcss.config.js或postcss.config.mjs改为postcss.config.cjs -
plugins必须是对象:{ tailwindcss: {}, autoprefixer: {} },不能是数组或require调用 - Next.js/Vite 新项目默认生成
postcss.config.mjs,这个格式 WebStorm 不支持,必须改
必须锁定 PostCSS 7 + Tailwind 2.1.4 兼容组合
WebStorm 内置语言服务深度绑定 PostCSS 7 生态。PostCSS 8+(包括 Next.js/Vite 默认版本)会导致提示中断,且无报错提示。
- 执行:
npm uninstall tailwindcss postcss autoprefixer - 再装兼容包:
npm install -D tailwindcss@npm:@tailwindcss/postcss7-compat@2.1.4 postcss@^7 autoprefixer@^9 - 删掉
node_modules和package-lock.json后重装,避免残留高版本缓存干扰解析
关 Power Save Mode + 手动重启语言服务
这是最常被忽略的“软开关”。只要 WebStorm 处于节电模式,Tailwind 补全、跳转、甚至 class 属性内语法高亮都会被强制禁用,界面没有任何提示。
- 菜单栏点
File → Power Save Mode,确保前面没勾选(有就点一下关掉) - 看右下角状态栏,找到
Language Service图标(类似 ⚙️ 或 ?),点击 → Restart Tailwind CSS Language Service - Vue/React 项目还需进
Settings → Languages & Frameworks → JavaScript → Libraries,勾选对应框架支持,否则class=""内不触发补全
真正卡住的地方往往不是配置写错,而是 WebStorm 没“看见”配置——它不加载 .ts 或 .mjs,不执行 require,也不理 PostCSS 8+。每一步都得对齐它的解析规则,而不是你的构建规则。


















