如何修复Less编译工具在Windows与Linux环境下的CSS差异？

Less编译结果在Windows和Linux下不一致的根本原因是路径解析、换行符、BOM及@import查找逻辑的隐式行为差异；修复关键在于统一环境假设，而非适配系统。

Less编译结果在 Windows 和 Linux 下不一致，根本原因不是“系统差异”，而是路径解析、换行符、BOM 和 @import 查找逻辑的隐式行为不同。修复的关键是统一环境假设，而不是适配系统。

Windows 下 @import 找不到文件？检查路径分隔符和 --include-path

Less 默认用正斜杠 / 解析 @import 路径，但 Windows 用户常写成 @import "mixinsvariables.less"; —— 这在 Node.js 的 Less 解析器里会被当作字面量字符串，而非路径，导致找不到文件或静默失败。

• 所有 @import 必须用正斜杠：@import "mixins/variables.less";，哪怕你在 Windows 上编辑
• 如果路径分散在多层子目录，别依赖相对路径自动推导，显式加 --include-path=src/less（Linux）或 --include-path=srcless（Windows 命令行需双反斜杠或引号包裹）
• VSCode 任务中写 lessc --include-path="${workspaceFolder}/src/less" ${file} ${fileDirname}/${fileBasenameNoExtension}.css，用 ${workspaceFolder} 避免硬编码路径

Linux 编译出错而 Windows 正常？先查 BOM 和不可见字符

Windows 记事本、Word 或某些设计稿导出的 .less 文件常带 UTF-8 BOM（EF BB BF），Linux 下的 lessc（尤其是 4.x+）会把它识别为非法开头字符，直接报 parse error: unrecognised input；Windows 的 Node.js 运行时有时会容忍它，造成“能过”的假象。

• 用 VSCode 打开 .less 文件 → 右下角点击编码 → 选 “Save with Encoding” → UTF-8（不是 UTF-8 with BOM）
• 终端执行 file -i your-file.less，若输出含 charset=utf-8; charset=bom，说明有 BOM，用 sed -i '1s/^xEFxBBxBF//' your-file.less 清除（Linux/macOS）
• 复制粘贴代码时，尤其从网页或 Figma 复制，容易混入零宽空格（U+200B）—— VSCode 开启 “Render Whitespace” 就能看到

编译后 CSS 行数/结构不一致？统一换行符和注释格式

Windows 默认用 CRLF（rn），Linux/macOS 用 LF（n）。Less 编译器本身不处理换行符标准化，但 source map 生成、嵌套块缩进、甚至某些插件（如 less-plugin-clean-css）对换行敏感，会导致输出 CSS 的空行、缩进、甚至属性顺序微调。

立即学习“前端免费学习笔记（深入）”；

• Git 用户：在项目根目录加 .gitattributes，写 * text=auto eol=lf，强制仓库内统一为 LF
• VSCode 设置 "files.eol": "n"，避免保存时自动转 CRLF
• 注释必须独占一行，且前后空行：/* 主色定义 */ 放在变量赋值后同一行（如 @primary: #333;/* */）会触发旧版 lessc 的解析错误，尤其在 Linux 下更严格

为什么 lessc 在两个系统输出的压缩 CSS 不一样？

压缩行为本身由插件控制（如 --clean-css），但插件版本、Node.js 版本、甚至 process.platform 判断都可能影响最终输出。Dart Sass 已弃用 node-sass，但 Less 生态里仍有部分插件未完全跨平台对齐。

• 不要依赖全局安装的插件版本：用 npm install --save-dev less less-plugin-clean-css，然后通过 npx lessc --clean-css ... 调用本地版本
• less-plugin-clean-css 的默认配置在不同平台下可能启用/禁用某些优化项（如移除最后分号、合并重复规则），加 --clean-css="--format" 强制格式化输出可比对
• Linux 下若用 Alpine 镜像构建，注意 musl libc 对浮点运算精度的影响——极少数涉及颜色函数（如 lighten(@color, 10%)）的计算结果会有小数点后第 4 位差异，不影响渲染

最隐蔽的差异点其实是 lessc 启动时读取的当前工作目录（process.cwd()）——Windows 命令行常以盘符根目录为默认 cwd，Linux 终端则取决于你 cd 到哪。一旦 @import 是相对路径，差一个 cd 就全崩。所以永远用绝对路径传入 lessc，或确保 CI/CD 和本地开发都在同一 cwd 下运行命令。