Less编译结果为空通常是因致命错误导致静默中止：变量未定义、@import路径404、语法非法（如零宽字符）、中文路径或编码问题等，而构建工具未拦截错误。
Less 编译结果为空，绝大多数情况是编译中途静默失败，而非“没输出”——你看到的空 CSS 文件，其实是 Less 解析器在遇到致命错误（如变量未定义、路径 404、语法非法）后提前中止，又因构建工具未阻断流程而生成了空内容。
为什么编译不报错却输出空 CSS
Less 本身会抛出明确错误（如 NameError: variable @primary-color is undefined），但很多环境会吞掉它：
- Webpack 的
less-loader默认不中断构建，throwOnImportError: false（旧版默认值）会让 import 失败只发警告 - VS Code 的 Easy LESS 插件已停更，v1.80+ 下常静默跳过编译，控制台无日志
- 命令行用
lessc input.less > output.css时，错误被重定向到 stderr，stdout 仍写入空文件 - Vue 单文件组件里
<style lang="less">是独立编译上下文，变量不会跨文件共享，引用未定义变量直接导致该块编译为空
@import 路径 404 导致整个文件失效
@import 失败不是“跳过”，而是让后续所有规则无法进入作用域。常见表现：文件开头就引用一个不存在的 @import "./vars.less"，后面写的全部样式都不见了。
- 检查路径是否真实存在：
ls ./src/styles/vars.less（Linux/macOS）或dir src\styles\vars.less（Windows） - 别名路径（如
@/styles/vars.less）必须加~前缀：@import "~@/styles/vars.less"，否则 Less 直接按字面量找目录 - Webpack 中若配了
resolve.alias，但less-loader没传paths或没启用implementation，~也无效 - 空的 .less 文件（0 字节）也会打断 import 链，导致后续内容全丢
变量未定义却没报错，只留占位符或空输出
看到 @primary-color 出现在 CSS 里，或整个 CSS 文件为空，基本可断定变量引用发生在定义之前。
立即学习“前端免费学习笔记（深入）”；
- Less 的
@import是顺序执行，没有预加载：变量定义必须出现在所有使用它的文件之前 - 入口文件（如
main.less）最顶部应为：@import "variables.less"; @import "mixins.less"; @import "components/button.less"; - 禁止在子文件里反向依赖父文件变量，比如
button.less开头就写color: @primary-color;，但它的@import "../variables.less"写在文件末尾 - Vue CLI 项目中，每个
<style lang="less">是隔离上下文，需显式@import "@/styles/variables.less"，不能指望全局注入
语法非法导致解析中断（尤其隐藏字符）
Less 词法分析器极敏感，遇到不可见字符直接停在那一行，后面全丢。这类问题最隐蔽，因为肉眼完全看不出异常。
- 复制网页或 Word 的代码？VS Code 打开“显示不可见字符”（Ctrl+Shift+P → “Toggle Render Whitespace”），揪出
U+200B（零宽空格）、U+00AD（软连字符）、UTF-8 BOM - 中文路径（如
@import "../组件/按钮.less"）会让 Less 直接崩溃，必须通过--include-path或less-loader.paths绕过原生解析 -
@import行末带注释（如@import "a.less"; /* 工具类 */）在 Less ≤3.13.x 中会黏连成非法 token，注释必须独占一行且前后空行 - 文件编码不是 UTF-8 无 BOM？用
file -i style.less验证，BOM 存在则用sed -i '1s/^\xEF\xBB\xBF//' style.less清除
真正难排查的，是那些不报错、不中断、但让整块样式消失的问题——比如变量作用域错位、空文件打断 import、或零宽字符卡在第一行。与其等输出为空再回头找，不如在入口文件顶部加一句 .debug { content: "compiled"; }，先确认编译链是否真跑通。
