less.render不是流式接口，仅接受字符串输入并返回字符串输出，不支持文件路径、流式处理或增量编译；高并发下易致内存堆积、OOM及事件循环阻塞，需配合LRU缓存、并发限制与超时控制。
less.render 是唯一能从 Node.js 服务端直接调用的动态编译入口，但它不是“流式”或“增量式”接口，所有输入必须是完整字符串，输出也是完整字符串。想在 HTTP 请求中实时编译 LESS 并返回 CSS，就得用它——但得避开常见内存和错误处理陷阱。
为什么不能直接传文件路径给 less.render
less.render 只接受 string 或 Buffer，不识别文件路径。你得自己用 fs.readFileSync 或 fs.promises.readFile 读取内容，再传进去。漏掉这步会报 TypeError: Expected string but found undefined。
- 别写
less.render('./theme.less', ...)—— 这会被当成源码字符串，不是读文件 - 路径需提前 resolve，尤其涉及
@import时：paths选项必须是绝对路径数组，比如[path.resolve(__dirname, 'node_modules/ant-design-less')] - 若 LESS 中有
@import 'variables.less'，而variables.less不在paths列表里，less.render会静默失败或抛出模糊的FileError
less.render 的异步模式与错误堆栈定位
回调函数里的 error 对象包含 filename、line、column 和 extract 字段，但默认不带原始 LESS 行号——除非你显式传入 sourceMap: { outputFilename: 'out.css' }。开启后会多出约 20% 内存开销，高并发下慎用。
- 错误发生时，
error.filename指向的是触发错误的那个@import文件，不一定是你最初传入的主文件 -
error.extract是三行上下文（含错误行），但只对语法错有效；变量未定义、mixin 不存在等逻辑错不会进extract - 别依赖
console.error(error)直接打印——它会丢掉line/column，应手动拼接：`${error.filename}:${error.line}:${error.column} ${error.message}`
如何安全支持运行时变量注入（比如主题色切换）
用 less.modifyVars 是错的——它只适用于浏览器端已加载的 less.js 实例，Node.js 环境无全局 less 上下文。正确做法是把变量作为 options.variables 传给 less.render：
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
立即学习“前端免费学习笔记（深入）”；
less.render(lessSource, {
paths: [path.resolve(__dirname, 'src/less')],
javascriptEnabled: false,
math: 'always',
variables: {
'@primary-color': '#1890ff',
'@border-radius-base': '6px'
}
})
-
javascriptEnabled: false必须显式关闭，否则@import中含 JS 表达式会触发安全警告甚至拒绝编译 - 变量值只能是字符串，数字或布尔要先
toString()，否则会被忽略 - 若变量名含连字符（如
@text-color），key 名必须加引号：'@text-color': '#333' - 变量覆盖优先级：传入的
variables> LESS 文件内@color: ...定义 > 默认值
高并发下避免 OOM 和延迟飙升的关键控制点
每个 less.render 调用都会生成完整 AST 并一次性吐出 CSS，在 QPS > 30 场景下极易堆积内存。V8 堆内存超过 1.4GB 后 GC 频次激增，响应时间从几 ms 涨到秒级。
- 加内存限制：启动时加
--max-old-space-size=1200（单位 MB），防止单个进程吃光内存 - 限制并发数：用
p-limit或undici的Pool控制同时最多 5–8 个less.render在跑 - 缓存编译结果：对相同
lessSource + JSON.stringify(variables)做 LRU 缓存（推荐quick-lru），命中率超 70% 时内存压力下降明显 - 超时强制中断：用
AbortController包裹 Promise，10 秒未返回就 reject，避免死循环 mixin 卡住整个事件循环
真正容易被忽略的是 @import 的路径解析顺序和错误静默行为——less.render 遇到找不到的 import 不一定抛错，有时只返回空 CSS，且不提示缺失了哪个文件。上线前务必用一组带嵌套 @import 的测试用例压测，观察 stderr 输出和返回内容是否符合预期。
