Electron中Tailwind CSS白屏主因是file://协议下相对路径解析失败，需改用绝对路径（如file://${path.join(__dirname, 'dist', 'styles.css')}）、内联样式或修正CSP策略，并确保构建产物正确复制且缓存已清除。
Electron 中 Tailwind CSS 白屏，90% 是路径没对上
不是 Tailwind 本身出错，而是 file:// 协议下相对路径（如 ./styles.css）根本不会按你预期解析。Electron 的 mainWindow.loadFile('index.html') 会让浏览器以 file:///path/to/app/index.html 为基准找 CSS，但实际 styles.css 很可能在 dist/styles.css 或 build/styles.css，导致 Network 面板里清清楚楚显示 net::ERR_FILE_NOT_FOUND。
解决思路只有两个硬方向：要么让路径绝对可定位，要么绕过路径加载。
- 用
mainWindow.loadURL('file://' + path.join(__dirname, 'index.html'))替代loadFile，再在 HTML 里写<link rel="stylesheet" href="file://${path.join(__dirname, 'dist', 'styles.css')}">（注意：必须在 Node.js 环境中拼接，不能写死） - 开发期快速验证？直接内联：用
fs.readFileSync读取dist/styles.css，注入到<style></style>块里 - 确保构建产物（CSS 文件）确实被复制进了最终打包目录，比如用
electron-builder的extraResources显式声明dist/
PostCSS 插件报错 “requires PostCSS 8”，本质是版本锁死
你在 Vue CLI 4 / Webpack 4 / 或老版 Electron 构建环境里跑 npx tailwindcss init -p，大概率撞上 Error: PostCSS plugin tailwindcss requires PostCSS 8。这不是配置写错了，是底层依赖树断层了 —— Vue CLI 4.x 锁死 postcss@^7，而 Tailwind v3.3+ 默认只认 postcss@8+。
别硬升 PostCSS，先确认你的构建工具链是否支持：
立即学习“前端免费学习笔记（深入）”；
- Vue CLI 4 / Webpack 4 → 必须降级 Tailwind：
npm install -D tailwindcss@npm:@tailwindcss/postcss7-compat@^3.4 - Vite 4+ / Webpack 5+ → 升级全家桶：
npm uninstall tailwindcss postcss autoprefixer && npm install -D tailwindcss@latest postcss@latest autoprefixer@latest - 如果用了 PNPM，加
--shamefully-hoist避免插件找不到postcss实例
CSP 策略拦住 CSS 加载，连 404 都不报
路径明明对了、文件也存在，DevTools Console 却安静得反常？打开 Console 看有没有类似 Refused to apply inline style because it violates the following Content Security Policy 的警告 —— 这说明 Electron 默认的 CSP meta 标签在作祟。
默认的 <meta http-equiv="Content-Security-Policy" content="default-src 'self'; script-src 'self'"> 没有显式允许 style-src，所以哪怕你写了 <style>...</style> 或 href="file://..."，也会被静默拦截。
- 临时调试：把 meta 改成
style-src 'self' 'unsafe-inline'; script-src 'self' - 生产环境必须去掉
'unsafe-inline'，改用style-src 'self' file://，且确保 CSS 路径是完整绝对路径（Electron 22+ 要求file:///abs/path/to/styles.css，不能省略协议后第一个/） - 注意：仅声明
file://不够，还得配对路径 ——file://源只匹配同协议同路径前缀的资源
Tailwind v4 在 Electron 里抽风，大概率是模块解析失败
Tailwind v4 把 CSS 导入逻辑收紧了，尤其当你混用 Fumadocs、Vite 插件或自定义 @import 规则时，很容易触发 Cannot find module './css/black.css' 这类报错。它不是文件丢了，是 v4 的 PostCSS 插件在 resolve 阶段校验更严，要求被 @import 的 CSS 必须在 package.json 的 exports 字段里显式声明。
常见于升级后突然失效的老项目：
- 检查你引用的 UI 库（如
fumadocs-ui）是否更新到了兼容 v4 的版本（比如 PR #1313 之后的） - 确认
tailwind.config.js的content字段覆盖了所有模板路径，v4 对未扫描文件里的 class 名字会直接忽略（不是报错，是静默丢弃） - 如果你用的是
postcss-import，确保它版本 ≥ 16，否则无法配合 v4 的模块解析机制
Electron 环境里最易被忽略的一点：路径拼接和 CSP 必须同步生效。写对了 file:// 绝对路径，却忘了在 CSP 里放开 file:// 源；或者开了 CSP，但路径少了一个 / 导致协议不匹配 —— 这两种情况都会让样式彻底消失，且无明确错误提示。
