必须显式启用TAILWIND_MODE=watch，否则v3+虽默认启用JIT引擎但热重载失效；需确保content路径全覆盖、构建工具HMR链路完整，并规避Windows路径陷阱。
TAILWIND_MODE=watch 必须显式启用
Tailwind v3+ 虽然默认启用 JIT 引擎，但热重载（文件变更后自动更新 CSS）并不是开箱即用的。它依赖构建工具主动监听 content 配置中声明的源文件，并在变化时触发增量编译。很多脚手架（如 Create React App、Vue CLI、Nuxt）默认不向 PostCSS 传递 watch 指令，导致 Tailwind “看不见” HTML/JSX/Vue 文件的修改。
根本解决方式是强制启用 watch 模式：
- Unix/macOS：在启动命令前加
TAILWIND_MODE=watch，例如"start": "TAILWIND_MODE=watch craco start" - Windows：必须用
cross-env包兼容环境变量，写成"dev": "cross-env TAILWIND_MODE=watch vue-cli-service serve" - 若已全局安装
cross-env，确保项目package.json的devDependencies中也声明了它，否则 CI 或新机器上会报错
content 路径未被正确扫描也会“假失效”
即使启用了 TAILWIND_MODE=watch，如果 tailwind.config.js 中的 content 数组没覆盖到你实际写类名的文件，Tailwind 就不会把那些类生成进 CSS，自然也就没有“更新”可言——它压根没编译过你改的那部分。
常见漏配场景：
立即学习“前端免费学习笔记（深入）”；
- 用了
.tsx但content只写了**/*.js，漏掉**/*.tsx - 模板文件在
src/pages，但配置里只写了src/components/**/*.{vue,js} - 使用了 Vite + Markdown（.md），却没加入
**/*.md - 路径用了相对写法如
../src/**/*，而 Tailwind 解析时基于配置文件所在目录，容易错位
验证方法：临时删掉 dist 或 .css 输出文件，运行构建，然后 grep 输出 CSS 文件里有没有你刚写的类名，比如 grep "p-6" output.css。没有，就是 content 扫描失败。
Vite / Webpack / CRACO 的 HMR 链路可能被截断
热更新不是 Tailwind 单独完成的，它需要构建工具把 CSS 变更通过 HMR 推送到浏览器。某些集成方式会让这一步断开：
- Vite 项目中，若手动用
@import引入 CSS，而不是通过import './index.css'，Vite 的 HMR 无法感知 Tailwind 输出的变更 - Create React App + CRACO：必须确认
craco.config.js正确将 Tailwind 作为 PostCSS 插件注入，且没覆盖webpackConfig.module.rules中原有的 CSS 处理规则 - Webpack 自定义配置中，若同时用了
MiniCssExtractPlugin（用于生产环境），开发时应禁用它，改用style-loader，否则 HMR 会退化为整页刷新 - Nuxt 3（基于 Nitro）需检查
nuxt.config.ts中是否设置了experimental: { watcher: 'parcel' }—— 这个选项与 Tailwind 的文件监听冲突，应移除
Windows 文件系统和路径命名的隐藏陷阱
在 Windows 下，某些路径特征会导致文件监控完全失效，且无任何错误提示：
- 项目文件夹名为“新建文件夹”或含中文、空格、emoji（如
my project?），Node.js 的fs.watch在这些路径下可能静默失败 - 项目放在 OneDrive、Google Drive 同步目录中，云同步客户端会干扰文件系统事件，导致变更不被触发
- WSL2 环境下，若项目路径在 Windows 文件系统（
/mnt/c/...），inotify 事件支持不完整，建议把项目移到 WSL2 原生文件系统（~/project）
最简单验证方式：改一个 JS 文件，看控制台是否打印 “compiled successfully”，如果 JS 能热更而 CSS 不能，大概率是 Tailwind 监听层的问题，不是构建逻辑问题。
