tailwind.config.js 在 v4 中仅保留 content 字段用于类名扫描，theme、plugins 等配置已失效；真正驱动样式的必须是 css 文件中的 @import "tailwindcss"; 和 @theme 块，否则类名静默不生成。
tailwind.config.js 在 v4 中不是“被抛弃”，而是被降级为仅服务 content 扫描的辅助文件；真正驱动样式的配置必须写进 CSS 文件里，否则类名根本不会生成——连报错都没有，只会静默失效。
为什么 tailwind.config.js 里的 theme、plugins 全部失效
v4 底层换用 Rust 编写的 Oxide 引擎，它不解析 JS 配置文件，只扫描 CSS 源码中的 @theme、@config、@import "tailwindcss" 等指令。你在 tailwind.config.js 里写的 theme.extend.colors 或 plugins，Oxide 引擎直接跳过，连 warning 都不抛。
- 常见错误：保留旧配置并以为它还在生效，结果
bg-primary、text-brand-500全部不输出 -
theme.colors.primary: '#3b82f6'写在 JS 里 → 完全忽略 -
@theme { --color-primary: #3b82f6; }写在 CSS 里 → 正确生成bg-primary - 插件如
tailwindcss/forms必须用@plugin "tailwindcss/forms"声明在 CSS 中，JS 的plugins: []数组已废弃
如何把旧配置迁移到 CSS 文件中
迁移核心是两件事：@import "tailwindcss" 替代三行 @tailwind，所有主题/变体/工具类逻辑挪到同一 CSS 文件的 @theme 或 @layer 块里。
Comprehensive Three.js 3D graphics reference
下载
详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
- 删掉
tailwind.config.js中除content外的所有字段（theme、darkMode、plugins、contentSecurityPolicy） - 在
src/styles/tailwind.css（或你的主 CSS 入口）顶部写：@import "tailwindcss";（注意：单引号 + 分号，缺一不可） - 紧接其后写
@theme块，变量名必须带标准前缀：--color-primary✅，--primary❌ - 自定义字体、间距等用
@config（需放在@import之前），但注意它只接受静态值，不能引用 CSS 变量 - 旧的
addUtilities插件逻辑，改用@layer utilities声明，例如：@layer utilities { .tap-highlight-color { -webkit-tap-highlight-color: rgba(0,0,0,0); } }
content 字段为什么还必须保留
content 是唯一仍在 tailwind.config.js 中起作用的字段，但它只干一件事：告诉 Oxide 引擎去哪扫描 HTML/JSX 中用到的类名。没它，开发时热更新不触发，生产构建漏类——比如你写了 flex gap-4，但构建产物里没有对应 CSS。
- 路径格式不变：
["./src/**/*.{js,jsx,ts,tsx}"]，Astro 项目照写["./src/pages/**/*.astro"] - 不要删掉整个
tailwind.config.js文件，只删字段；空文件或缺失content都会导致扫描失败 - 如果你用的是 Vite + `@tailwindcss/vite` 插件，它仍依赖这个字段做 HMR 注册
容易被忽略的静默失效点
v4 的错误不是报错，而是“什么都没发生”：类名不生成、颜色不推导、暗色模式不切换。最容易卡住的地方往往藏在细节里。
-
@import "tailwindcss"写成双引号、漏分号、或拆成多行 → 整个 Tailwind 基础样式（text-lg、flex）全部消失 -
@theme块写在@import之前 → 被忽略，--color-primary不生效 - OKLCH 颜色值（如
oklch(0.62 0.15 274)）用于自动推导阶梯色，但旧浏览器（Chrome 109、iOS Safari ≤13.3）会整条声明丢弃，且无提示 - 跨文件声明
@theme（比如在theme.css里写）→ 不生效，必须和@import "tailwindcss"在同一 CSS 文件内
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
