@theme 必须紧接在 @import 'tailwindcss'; 之后且使用标准前缀（如 --color-primary），否则 Oxide 引擎无法识别，导致 bg-primary 等类静默不生成；@import 必须用单引号加分号，@theme 需置于 @layer base 内，tailwind.config.js 的 theme 配置在 v4 中已失效。
@theme 必须写在 @import 'tailwindcss' 之后，且变量名必须带标准前缀——否则所有自定义类（如 bg-primary、text-sans）静默不生成，不报错，也不警告。
为什么 @theme 声明后工具类仍不生效？
根本原因是 Oxide 引擎只扫描特定前缀的 CSS 自定义属性，拼错一个连字符或少写一个 - 就等于没写。常见失效写法包括：--primary、--my-color、--colorPrimary（缺连字符）、--color-primary:（冒号后多空格）。有效写法严格限定为：
- 颜色：必须以
--color-开头 →--color-primary: #3b82f6;→ 生效bg-primary - 字体：必须以
--font-开头 →--font-sans: 'Inter', sans-serif;→ 生效font-sans - 间距/尺寸：用
--spacing-或--size-→--spacing-6: 1.5rem;→ 生效p-6 - 断点：用
--breakpoint-→--breakpoint-sm: 480px;→ 自动生成sm:变体
@import 'tailwindcss' 的写法为什么不能错？
v4 彻底废弃所有 @tailwind 指令，Oxide 引擎只识别标准 CSS @import 语句。旧写法不会报错，但基础类全丢：
- ❌ 错误：
@tailwind base;+@tailwind components;+@tailwind utilities; - ❌ 错误：
@import "tailwindcss";（双引号）或@import 'tailwindcss'（缺分号） - ✅ 正确：
@import 'tailwindcss';（单引号 + 分号缺一不可） - 如果项目里还装着
postcss-import，得彻底删掉，否则可能重复解析或冲突
@theme 和 tailwind.config.js 谁管什么？
tailwind.config.js 在 v4 中只剩两个作用：指定 content 扫描路径（当自动检测失败时），以及加载插件（如 daisyui）。其他字段（theme、darkMode、plugins）全被跳过。
-
@theme是唯一参与类名生成的主题声明方式，必须在同一 CSS 文件中，且紧接在@import 'tailwindcss';后面 -
@config支持有限静态配置（如theme.colors、theme.spacing），但必须写在@import之前；它只影响当前文件，跨文件不生效 -
theme.extend.colors在tailwind.config.js里完全无效 —— 即使存在，也不会触发bg-primary生成
VS Code 和构建工具为啥提示“找不到类”？
不是插件坏了，是路径或顺序没对上。v4 默认不读 tailwind.config.js，它只认 CSS 入口文件里的 @import 和 @theme。
立即学习“前端免费学习笔记（深入）”；
- VS Code 插件默认扫描
tailwind.config.js，删了它就得手动设置"tailwindCSS.experimental.configFile"指向主 CSS 文件（如src/styles/main.css） - Vite / Next.js 若没识别到含
@import 'tailwindcss';的入口 CSS，会静默跳过所有 Tailwind 处理 - 最易忽略的是：变量必须定义在
@layer base块内，否则可能被 Tailwind 默认样式覆盖
