Less循环引用导致编译卡死或堆溢出，根源是@import形成闭环，需升级Less版本、改用@import(inline)暴露错误、用postcss-import定位链路，并避免@import(reference)误用及深层嵌套。
Less循环引用导致编译卡死或FATAL ERROR: JavaScript heap out of memory
这不是内存不足，是@import文本拼接形成闭环（如 A.less → B.less → C.less → A.less），编译器反复展开直至堆溢出。它不报“循环依赖”，只静默卡住或崩溃。
- 立刻运行
npx lessc --version，若 ≤ 3.9.0，升级到less@^3.13.1或less@^4.2.0—— 新版 AST 回收优化能降内存 40%+ - 临时把所有
@import改成@import (inline)：循环会立刻暴露为Variable @xxx is undefined或Cannot access property错误，错误行就是断点 - 在 Webpack/Vite 中用
postcss-import替代原生@import，报错时直接打出完整链路：A.less → B.less → C.less → A.less - 在疑似文件顶部加
// @DEBUG: imported by X，全局搜索imported by，5 分钟内画出依赖图
为什么@import (reference)不能解决循环变量未定义
@import (reference) 只控制“样式是否输出”，不改变解析顺序，也不让变量/mixin 提前进入作用域。A 引用 B 的 @import (reference)，B 再调 A 定义的 .btn()，依然报 Undefined mixin '.btn'。
- 真正安全的复用只有两种：
tokens.less作为唯一根文件（只含@variable/@mixin，禁止任何@import），或把逻辑下沉到 JS 层（CSS 自定义属性 + JS 计算） - 拆解典型互引（如
typography.less↔spacing.less）：删掉双方互相引用的部分，统一从core/tokens.less读取，且确保tokens.less是第一个被@import的文件 - 第三方 UI 库的 Less 文件也可能自带循环，升级库版本后突然卡死，就得用
postcss-import检查其内部链路
Less编译中断报ParseError: Unrecognised input但路径没中文
多数不是编码问题，而是词法分析器被零宽字符、BOM 或注释黏连绊倒——它根本不尝试解码，遇到非法 token 就停。
- VS Code 开启“显示不可见字符”，揪出
U+200B（零宽空格）、U+00AD（软连字符）、UTF-8 BOM；复制网页/Word 代码进来极易带这些 -
@import行末加/* 工具类 */注释？旧版 Less（如 3.13.x）会把;和/*黏在一起当成不完整声明，注释必须独占一行且前后空行 - 路径含中文（如
@import "../组件/按钮.less"）？构建工具绕过原生解析：webpack配less-loader的paths，vite配preprocessorOptions.less.paths，命令行用--include-path=src，然后所有@import改写成纯 ASCII 路径
样式生成了但内容丢失或错乱
这类问题最隐蔽：不报错，但 CSS 没按预期输出，根源常在调用点而非定义点。
立即学习“前端免费学习笔记（深入）”；
-
.flex-center没括号？Less 把它当选择器处理，整块规则静默丢弃；所有 mixin 调用必须带()，哪怕无参也要写.flex-center() - 嵌套里漏括号高发：
&:hover { .transition(); .color-change; }第二处没()，后续样式全失效 -
/deep/或::v-deep直接写进 Less？Less 不认识，整个文件编译失败；要用变量转义：@deep: ~">>>"; @{deep} .cube-btn { background: red; } - 四层以上嵌套（如
.layout .sidebar .content .item）导致权重爆表，且深层嵌套每层新增独立 AST 节点，20 层 ≈ 百万级节点——超过 15 层就该压平
复杂点在于循环常藏在三层以上 @import 链里，比如 button.less → theme.less → mixins.less → button.less，肉眼极难发现；更麻烦的是 @import (reference) 会让问题更隐蔽——它让文件“看似没参与编译”，实则变量仍在作用域里乱窜。
