Tailwind CSS v4 并未取消 tailwind.config.js，而是将其降级为可选兜底配置；Oxide 引擎默认不读该文件，仅当启用 JS 兼容层时才生效，且推荐改用 @config 和 @theme CSS 规则替代。
Tailwind CSS v4 并没有“取消”tailwind.config.js，而是把它降级为可选的兜底配置文件——Oxide 引擎根本不读它，除非你显式启用 JS 兼容层（不推荐）。
为什么 tailwind.config.js 在 v4 中静默失效
Oxide 引擎是纯 Rust 编写的编译器，构建时只扫描 CSS 源码中的标准 at-rule，比如 @import 'tailwindcss';、@theme、@config。它跳过所有 JS 文件，包括 tailwind.config.js；哪怕文件存在、语法正确、甚至写了 theme.extend.colors.primary，也不会触发任何类生成。
-
tailwind.config.js里定义的colors、spacing、fontSize等主题项，v4 完全忽略 -
darkMode、plugins、variants这些字段也不再被识别 - 唯一可能起作用的字段只剩
content（用于指定扫描路径）和plugins（仅限加载插件如 daisyui），且仅在 CLI 或某些构建工具未自动检测时才需要
@theme 和 @config 怎么替代 JS 配置
v4 把配置语义彻底交还给 CSS：主题变量必须写成带前缀的 CSS 自定义属性，声明在 @theme 块里；静态基础配置（如断点值、颜色名映射）用 @config 声明。二者都必须出现在同一 CSS 文件中，且顺序严格：
-
@config必须在@import 'tailwindcss';之前，且只能出现一次 -
@theme必须在@import 'tailwindcss';之后，变量名必须带标准前缀，例如--color-primary✅，--primary❌ - 值必须是静态的：支持
#3b82f6、oklch(0.62 0.15 274)、480px，但不能是 JS 表达式、CSS 变量引用或字符串拼接
例如，这段 CSS 才能真正生成 bg-primary 和 text-primary-400：
立即学习“前端免费学习笔记（深入）”；
@import 'tailwindcss';
@theme {
--color-primary: oklch(0.62 0.15 274);
}
删掉 tailwind.config.js 后常见失效原因
很多人删了文件却发现 bg-primary 不生效、断点类没输出、VSCode 没提示——问题几乎都出在 CSS 层的声明细节上：
-
@import 'tailwindcss';写成了双引号"tailwindcss"或漏了末尾分号 → Oxide 静默跳过，整个 Tailwind 处理链中断 -
@theme块写在@import之前，或跨文件声明（如在Button.css里写@theme）→ 作用域不生效 - VSCode 插件仍默认找
tailwind.config.js→ 必须手动设置"tailwindCSS.experimental.configFile"指向你的主 CSS 入口文件 - 项目用了自定义模板（如
.astro、.svelte），但没在tailwind.config.js中补content字段 → JIT 引擎扫描不到类名，样式漏生成
最常被忽略的是：v4 的“零配置”不是删文件就完事，而是把配置权移交到 CSS 层——移交失败时，不会报错，只会静默不生成对应类名。
