Node.js堆内存不足导致Tailwind编译失败，本质是PostCSS插件链（尤其JIT模式、宽泛content扫描）耗尽V8默认堆空间；最直接有效方案是修改package.json的dev脚本为"dev": "node --max-old-space-size=4096 next dev"，并严格限定tailwind.config.js中content路径。
Node.js堆内存不足导致Tailwind编译失败
Next.js + Tailwind 项目在 npm run dev 启动时抛出 FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory，本质不是Tailwind本身写得差，而是PostCSS插件链（尤其配合JIT或大量@apply、扫描路径过宽时）在Node默认内存限制下撑爆了V8堆空间。Ubuntu/WSL/macOS都常见，Next.js 10–13、Tailwind 2.x–3.x均出现过类似报告。
给Node进程增加--max-old-space-size参数
这是最直接有效的缓解手段，无需改代码或降级版本。关键在于：必须作用于启动项目的Node进程，而不是全局Node或单独跑tailwindcss -i ...命令。
- 修改
package.json中的dev脚本："dev": "node --max-old-space-size=4096 next dev"（单位MB，4GB是较稳妥起点） - 若用Yarn：
"dev": "node --max-old-space-size=4096 yarn next dev"或更准确地yarn node --max-old-space-size=4096 ./node_modules/.bin/next dev - Windows PowerShell用户注意：不要用
%NODE_OPTIONS%环境变量方式，容易被忽略；直接写死在脚本里最可靠 - 不建议设到8192+，除非你有32GB以上内存——过高反而触发GC抖动，实际构建变慢
配合Tailwind配置减少扫描压力
单靠加内存只是治标。Tailwind的content字段若包含./**/*.js这种宽泛glob，会导致PostCSS反复读取、解析、正则匹配成千上万文件，堆内存消耗呈线性增长。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 严格限定
content路径，例如只写：content: ["./src/**/*.{js,jsx,ts,tsx}", "./app/**/*.{js,jsx,ts,tsx}"]（Next.js App Router需包含./app） - 删掉注释、测试文件、
node_modules子目录等无关路径——哪怕多一个./tests/**/*.test.js都可能引入数百个无用匹配 - 禁用JIT模式（仅限开发临时救急）：
在tailwind.config.js中设mode: 'aot'（Tailwind 3.4+已弃用该配置，改用content精准控制） - 避免在CSS文件中大量使用
@apply组合长类名——每条@apply都会让PostCSS多做一次依赖分析
为什么不能只靠NODE_OPTIONS环境变量
很多人试过NODE_OPTIONS=--max-old-space-size=4096 npm run dev，但经常失效。原因很实在：
立即学习“前端免费学习笔记（深入）”；
- npm脚本会派生子shell，部分Shell（尤其是旧版bash/zsh）不保证将
NODE_OPTIONS透传给最终执行next的Node进程 - Next.js CLI内部可能调用
fork()或spawn()启动新Node实例，这些新进程默认不继承父进程的NODE_OPTIONS - 某些CI环境（如Vercel、Netlify）会重置环境变量，导致本地有效、线上仍崩
- 最稳的方式永远是：把
--max-old-space-size直接焊死在启动命令最前面
真正棘手的不是加内存，而是当项目里混着next/image + @apply + 全量content扫描 + 自定义PostCSS插件时，内存消耗会非线性飙升——这时候光调参没用，得一层层砍掉冗余扫描和样式抽象。
