webstorm的tailwind智能提示需同时满足三点:tailwind.config.cjs用module.exports导出、postcss.config.cjs中plugins为对象字面量、关闭power save mode;缺一不可,且不支持export default或.ts配置文件。

tailwind.config.cjs 必须用 module.exports 导出
WebStorm 不解析 export default 或 tailwind.config.ts,哪怕构建能跑,IDE 也静默跳过。这是硬性限制,不是 bug。
- 删掉
tailwind.config.js或tailwind.config.ts,新建tailwind.config.cjs - 内容必须是
module.exports = { content: [...] },不能用 ES 模块语法 -
content字段要覆盖所有模板路径:Vue 项目至少写./src/**/*.{vue,js,ts,jsx,tsx},漏掉.tsx就会导致 TSX 文件里无提示 - 右键
tailwind.config.cjs→ Reload project,或菜单栏 File → Reload project from disk
postcss.config.cjs 插件必须写成对象字面量
WebStorm 的 Tailwind 语言服务不执行 require(),只认 plugins: { tailwindcss: {}, autoprefixer: {} } 这种写法。
- 删掉
postcss.config.mjs(Vite/Next 默认生成的),新建postcss.config.cjs - 确保内容是
module.exports = { plugins: { tailwindcss: {}, autoprefixer: {} } },别简写成require('tailwindcss') - 如果用了 PostCSS 8+,提示大概率失效;降级方案:
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 是默认关闭语言服务的开关
这个选项关掉了,Tailwind 补全、跳转、class 属性内高亮全停——但 IDE 不报错,也不提示,是最隐蔽的“没提示”原因。
- 菜单栏 File → Power Save Mode,确认前面**没有勾选**(有就点一下关掉)
- 看右下角状态栏,找到 Language Service 图标(⚙️ 或 ?),点击 → Restart Tailwind CSS Language Service
- Vue 项目还需检查:Settings → Languages & Frameworks → JavaScript → Libraries 中是否已启用 Vue.js 支持,否则
class属性不触发补全
Vue 模板中 class 属性补全失效的常见漏点
即使配置全对,Vue 单文件组件里 class 仍不提示,往往卡在框架识别或路径匹配上。
- 确认
content路径包含.vue扩展名,且路径是相对项目根目录的(不是相对src) - 如果用的是
<script setup></script>+defineProps的组合,确保 WebStorm 已识别为 Vue 3 项目(Settings → Languages & Frameworks → JavaScript → Vue.js 版本设为 3.x) - 某些自定义文件后缀(如
.vux)需手动加到content数组中,否则不扫描 - 类名提示出来但没 CSS 预览?那是另一个层级的问题——WebStorm 默认不内联渲染 Tailwind 类,这不是配置失败,而是设计如此
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











