必须保留 tailwind.config.js 文件且至少包含 content 字段，因其是 Oxide 引擎扫描类名的唯一依据；v4 中 theme、plugins 等字段已失效，相关配置须改用 CSS 中的 @theme 和 @plugin 声明，并严格遵循语法与顺序要求。

不能彻底弃用 tailwind.config.js，它必须存在且至少保留 content 字段；所谓“零配置”只是把主题、插件等逻辑移到 CSS 层，而非删除配置文件本身。

为什么删掉 tailwind.config.js 会导致样式全丢

Oxide 引擎只靠 content 字段扫描 HTML/JSX 中出现的类名。没这个字段，构建时根本不知道该生成哪些类——flex、text-lg、bg-primary 全部静默不输出，连报错都没有。

• content 是唯一仍在起作用的字段，路径格式不变：["./src/**/*.{js,jsx,ts,tsx}"]
• 其他字段（theme、plugins、darkMode）在 v4 中已完全失效，删了不影响运行，但留着会误导你“配置还在生效”
• 空文件可以保留，但不能删除整个 tailwind.config.js（截至 2026 年 9 月）

@import "tailwindcss" 必须写对，否则基础类全失效

v4 废弃所有 @tailwind 指令，改用标准 CSS @import 触发引擎。语法错一个字符，Oxide 就静默跳过，不报错也不生成任何工具类。

Pandas 配置文件报告生成器

使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。

下载

• 必须写成 @import "tailwindcss";（单引号 + 末尾分号，缺一不可）
• 不能写成双引号：@import "tailwindcss"; → 无效
• 不能漏分号：@import "tailwindcss" → 无效
• 不能拆成多行：@tailwind base/@tailwind components → 完全忽略
• 必须放在主 CSS 入口文件顶部（如 src/index.css），且是第一个有效声明

@theme 和 @plugin 必须写进 CSS 文件，且顺序敏感

所有主题定制和插件逻辑，现在都得挪到 CSS 文件里，不能再靠 JS 配置驱动。

立即学习“前端免费学习笔记（深入）”；

• @theme 必须紧接在 @import "tailwindcss"; 之后，变量名必须带标准前缀：--color-primary ✅，--primary ❌
• @theme 作用域是文件级的：你在 Button.css 里写，不会影响 Header.css
• 插件如 @tailwindcss/forms 必须用 @plugin "@tailwindcss/forms" 声明，不能写在 tailwind.config.js 的 plugins: [] 里
• 值支持 OKLCH（如 oklch(0.62 0.15 274)）才能自动生成明度阶梯（primary-400/primary-600）

最容易被忽略的是作用域隔离和顺序依赖：CSS 文件里少一个分号、多一行注释、变量名漏掉 --color- 前缀，类名就彻底消失，且没有任何提示。