根本原因是content配置路径未匹配容器内文件结构，必须将tailwind.config.js中的content设为绝对路径（如"/usr/src/app/src/*/.{js,jsx,ts,tsx,html}"），并确保docker构建时源码真实存在该路径，同时删除已废弃的purge字段。
根本原因不是环境变量，而是 content 配置路径未匹配容器内文件结构 —— 大多数人查 NODE_ENV、TAILWIND_MODE 等变量纯属白忙，真正卡住编译的是 Tailwind 在容器里压根没扫描到你的 HTML/JS 文件。
tailwind.config.js 的 content 路径在 Docker 中必须指向容器内真实路径
你在宿主机上写 content: ["./src/**/*.{js,jsx,ts,tsx,html}"]，但 Docker 构建后，源码实际位置可能是 /app/src/ 或 /usr/src/app/（取决于 WORKDIR）。Tailwind 扫描失败，就等于“看不见你写的类”，自然不生成 CSS。
- 运行容器后手动进 shell：执行
ls -la /usr/src/app/src/（或你设的 WORKDIR）确认 HTML/JS 文件是否真在那里 - 把
content改成绝对路径：content: ["/usr/src/app/src/**/*.{js,jsx,ts,tsx,html}"]（注意开头的/） - 如果用多阶段构建，确保
content指向构建阶段最终复制进去的路径，而不是构建前的临时目录
purge 选项在新版本中已废弃，但旧配置残留会静默失效
如果你的 tailwind.config.js 还保留着 purge: [...] 字段，而 Tailwind 版本 ≥ v3.0（2022 年后基本都如此），这个字段会被完全忽略——但不会报错。结果就是：你改了 purge 却毫无作用，还以为是路径问题。
- 检查当前 Tailwind 版本：
npx tailwindcss --version - v3+ 必须用
content，删掉所有purge字段 - 若误写成
content: purge: [...]这种嵌套结构，Node.js 加载配置会失败，但某些构建流程可能吞掉错误，导致空 CSS 输出
Docker 构建时 node_modules 污染导致 JIT 编译器无法启动
本地开发时 node_modules 是完整的，但 Docker 构建中若用了 COPY package*.json . + RUN npm install，再 COPY . .，就可能把宿主机的 node_modules 也覆盖进容器——尤其是挂载卷或 .dockerignore 配置不当的时候。损坏的 node_modules 会让 tailwindcss CLI 启动 JIT 引擎失败，却只输出极简日志，看起来像“没反应”。
- 构建前先清理本地
node_modules和package-lock.json，再重新npm install - Dockerfile 中确保
.dockerignore包含node_modules、dist、.git - 构建时加
--no-cache参数排除缓存干扰：docker build --no-cache -t myapp .
最常被跳过的环节：在容器里直接跑一次 npx tailwindcss -i ./src/input.css -o ./dist/output.css --minify，看输出 CSS 是否包含你用到的类（比如搜索 .text-blue-500）。不验证这一步，所有环境变量、watch 配置、插件开关都是在猜。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
