ci中less编译失败的根本原因是构建脚本沿用开发行为且lessc缺少显式参数：必须加--js启用js支持、--include-path指定查找根目录，禁用ide自动编译和浏览器less.js，所有路径需纯ascii，版本不低于3.13.1或4.2.0。
CI环境编译Less失败，根本原因不是“环境没配好”，而是构建脚本沿用了开发期行为，或对lessc的运行约束缺乏显式声明——它在CI里根本不会自动补全路径、启用JS、容忍错误或等待文件变化。
lessc 命令没加 --js 就必然失败
很多项目用@plugin、unit()、percentage()，或依赖@import解析~node_modules别名。这些功能默认被lessc禁用。不加--js（等价于javascriptEnabled: true），编译会在第一处@import或函数调用时静默中断，输出里残留@primary-color这类占位符，而不是报错。
- 错误写法：
lessc src/less/main.less dist/css/main.css - 正确写法：
lessc --js --include-path=src/less src/less/main.less dist/css/main.css - 若用
npm run build封装，确保scripts里调用的是带--js的完整命令，而非只写lessc *.less
路径解析失败常因 --include-path 缺失或错位
lessc不识别Webpack的resolve.alias或~前缀。遇到@import "~antd/less/variables.less"，它直接报File not found。必须用--include-path显式告诉它从哪开始找。
如果你了解HTML，CSS和JavaScript，您已经拥有所需的工具开发Android应用程序。本动手本书展示了如何使用这些开源web标准设计和建造，可适应任何Android设备的应用程序 - 无需使用Java。您将学习如何创建一个在您选择的平台的Android友好的网络应用程序，然后转换与自由PhoneGap框架到一个原生的Android应用程序。了解为什么设备无关的移动应用是未来的潮流，并开始构建应用程序，提供更
-
--include-path应指向src/less或node_modules根目录，不能是相对路径如./src/less（CI中工作目录不确定） - 多个路径用冒号分隔（Linux/macOS）或分号（Windows）：
--include-path=src/less:node_modules - 所有
@import语句必须写成纯ASCII路径：@import "antd/less/variables.less"，不能含中文或空格
编译中断却不报错，是因为构建工具吞了错误
某些CI配置下，lessc出错后退出码非0，但Shell脚本没检查$?，或Webpack的less-loader设了throwOnImportError: false，结果CSS文件生成了，内容却是未处理的源码片段。
- 在CI脚本末尾加
set -e，让任意命令失败立即中断 - 用
npx lessc --version确认版本≥3.13.1或4.2.0，旧版对错误恢复更弱 - 避免用IDE插件（如Easy LESS）生成CSS再提交——CI节点没装插件，也无GUI环境
循环@import或深层嵌套导致进程卡死
Less的@import是文本拼接，不是模块加载。A→B→C→A这种环状引用不会语法报错，而是让Node堆内存爆掉，日志只显示FATAL ERROR: JavaScript heap out of memory，没有堆栈。
- 临时删掉所有
@import (reference)和@import (inline)，让导入全部展开——循环会立刻暴露为variable is undefined或Undefined mixin - 用
postcss-import替代原生@import，它能打印完整链路：A.less → B.less → C.less → A.less - 禁止组件级
@import，所有@import集中到main.less顶部，按variables → mixins → base → components顺序排列
最易被忽略的一点：CI里没有“保存即编译”这回事。任何依赖文件监听、IDE自动触发、浏览器端less.js的行为，在CI中都不存在。所有路径、JS支持、错误中断，都必须靠lessc命令行参数显式声明，少一个就可能产出空白CSS或占位符。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
