@apply报错主因是postcss未处理文件或tailwind插件缺失上下文，非语法错误；需分三类排查：postcss流水线是否接入、类名是否被content扫描注册、作用域隔离是否阻断全局工具类访问。
@apply 编译报错，基本不是语法写错了，而是 PostCSS 没走到 Tailwind 插件，或插件没拿到类名上下文。 它根本不是 CSS 原生规则，浏览器不认、编辑器标黄、构建失败——三者原因完全不同，得分开查。
PostCSS 根本没处理这个文件
你写了 @apply bg-blue-500;，但样式完全不生效，控制台也没报错？大概率是文件压根没进 PostCSS 流水线。
- Vite 默认只处理
src/下的.css文件；public/或assets/里的 CSS 不会过 PostCSS，@apply直接被忽略 - 用了
lang="scss"却没配好链式处理：SCSS 编译必须在 PostCSS 之前，否则@apply还没被展开就进了 Sass 解析器，直接报错或静默丢弃 - Vite 项目启用了
css.preprocessor: 'scss'，但没在postcss.config.cjs里声明tailwindcss插件——Sass 处理完就结束了，Tailwind 根本没机会介入 - Next.js 的
app/目录下，全局 CSS 必须叫app/globals.css，否则@tailwind指令不会被识别为入口
类名未被扫描注册（Cannot apply unknown utility class）
PostCSS 跑了，也报了 Cannot apply unknown utility class，说明 Tailwind 插件启动了，但找不到你写的类名。
如果你了解HTML，CSS和JavaScript，您已经拥有所需的工具开发Android应用程序。本动手本书展示了如何使用这些开源web标准设计和建造，可适应任何Android设备的应用程序 - 无需使用Java。您将学习如何创建一个在您选择的平台的Android友好的网络应用程序，然后转换与自由PhoneGap框架到一个原生的Android应用程序。了解为什么设备无关的移动应用是未来的潮流，并开始构建应用程序，提供更
-
tailwind.config.cjs里content字段没覆盖到当前文件路径，比如你在src/pages/Home.vue里用了bg-red-900，但content只写了./src/**/*.{js,ts}，漏了vue后缀 - Tailwind v3.3+ 默认只扫描
src/**/*.{html,js,ts,jsx,tsx}，Vue/Svelte 文件需显式加上vue或svelte - 类名拼错，比如
text-gray-800写成text-gray-80；或用了未启用的变体，如disabled:hover:bg-gray-200——disabled:默认不启用，得在配置中加plugins: [require('@tailwindcss/forms')]或手动开启
作用域隔离导致访问不到全局工具类
Vue/Svelte 单文件组件里 @apply 静默失效，或者报 Are you using CSS modules or similar and missing <code>@reference，就是作用域切断了上下文。
-
<style scoped></style>或Button.module.css会做哈希隔离，@apply展开后生成的规则是全局的，但选择器被套上了[data-v-xxx]，无法匹配 - Tailwind v3.3+ 必须在
<style></style>块顶部第一行写@reference "tailwindcss";，否则插件不把全局工具类注入当前作用域 - 别在
<style lang="scss"></style>里混用@use和@apply：@use是 Sass 的模块机制，会提前截断 Tailwind 的类名注入时机 - uni-app、Taro 等跨端框架的小程序平台，
@apply通常不支持——因为小程序 wxss 不支持 PostCSS 处理，只能靠构建时预展开，而多数插件没做这层适配
VSCode 显示 Unknown at rule @apply，但构建正常
这只是编辑器校验警告，不影响运行。VSCode 内置 CSS 语言服务不认识非标准指令，和构建流程无关。
- 最快解决：在 VSCode 设置里搜
css.lint.unknownAtRules，把值从warning改成ignore - 但仅设
ignore会丢失补全、跳转、颜色预览——必须同时装官方插件Tailwind CSS IntelliSense - 插件依赖
tailwind.config.cjs存在且content字段正确，否则它连类名都索引不到，补全就形同虚设 - 别用 ES module 写法配
postcss.config.cjs：export default { plugins: [...] }是错的；必须用module.exports = { plugins: { tailwindcss: {}, autoprefixer: {} } }
真正难排查的是“构建成功但样式没出来”——这时候问题往往不在 @apply 本身，而在 PostCSS 是否接管、类名是否注册、作用域是否打通。三个环节任一缺失，都会让 @apply 看似写了，实则没动。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
