先确认已安装Tailwind CSS插件、项目含tailwindcss包、存在tailwind.config.js；@tailwind指令须在被引用的主CSS中按base/components/utilities顺序书写；修改content后需重启语言服务器；theme.extend自定义须严格遵循命名与值类型规范。
找不到 Tailwind 类名补全？先确认这三件事
PhpStorm 默认不带 Tailwind 支持，必须手动装插件、配 Node.js、拉配置文件，缺一不可。很多人卡在“写了 text-blue-500 没提示”，其实根本没走通初始化流程。
- 确保已安装
Tailwind CSS插件：打开 Settings/Preferences → Plugins → Marketplace，搜Tailwind CSS并安装（不是“CSS”那个默认插件） - 确认项目里有
tailwindcss包：终端运行npm list tailwindcss，没输出就补装npm install -D tailwindcss - 必须存在
tailwind.config.js：哪怕只是空配置，也得用npx tailwindcss init生成；Tailwind CSS v3 及以上版本只认这个文件，不认tailwind.js或其他名字
为什么 @tailwind 指令不生效？路径和导入顺序是关键
PhpStorm 的语言服务器靠扫描 CSS 文件里的 @tailwind 指令（如 @tailwind base）来激活上下文，但只对“被项目实际引用”的 CSS 文件起作用——不是所有 .css 都算数。
-
@tailwind必须写在你真正通过<link>引入的主 CSS 文件里，比如src/styles.css；别写在node_modules里或未引用的临时文件中 - 顺序不能错：
@tailwind base→@tailwind components→@tailwind utilities，漏掉或颠倒会导致部分类名无法识别 - 如果用的是 Laravel Mix/Vite 等构建工具，确保最终产出的 CSS 是从含
@tailwind的源文件编译而来，而不是直接复制了未处理的原始文件
修改 content 字段后补全仍不更新？重启语言服务比重启 IDE 更快
PhpStorm 的 Tailwind 语言服务器会缓存模板路径扫描结果。tailwind.config.js 里改了 content 数组（比如加了 "./pages/**/*.vue"），不手动刷新，它根本不会重新扫描新文件。
- 别关 IDE，直接点右下角状态栏的
Tailwind CSS小图标（图标是 ? 或⚙️），选 Restart language server - 如果点不动，检查是否启用了本地 Node.js 解释器：进 Settings → Languages & Frameworks → Node.js and NPM，路径不能为空且指向有效
node可执行文件 - 常见坑：
content里用了相对路径但没加./，例如写成"src/**/*.{html,js}"（缺点）→ 应为"./src/**/*.{html,js}"
颜色/断点自定义后没提示？theme.extend 写法要严格匹配类型
你在 tailwind.config.js 里加了 theme.extend.colors.myRed: "#ef4444"，但写 bg-myRed 还是没补全——大概率是 JS 类型推导失败，或者扩展字段名拼错了。
立即学习“PHP免费学习笔记（深入）”；
- 必须用
extend，不能直接写theme.colors；否则语言服务器读不到你的自定义项 - 键名要合法：只支持字母、数字、短横线，不能有下划线或大写字母，比如
my_red或MyRed都无效 - 值必须是字符串或对象（如渐变），不能是函数或变量引用；
myRed: MY_RED_CONST这种外部变量不会被解析
tailwind.config.js 是否存在、是否被读到、是否语法干净，而不是怀疑插件或 IDE。 
