less插件需先注册到less.plugins数组并传入plugins选项才能生效，@plugin规则须在顶层且路径相对，插件对象必须有install方法，node.js环境需导出函数，浏览器需确保脚本提前加载。
Less插件怎么注册和加载
Less 3.0+ 支持通过 JavaScript 插件扩展编译行为，但插件不是写完就能用——必须显式注册到 less.plugins 数组，并在调用 less.render() 或 less.parse() 时传入 plugins 选项（或全局启用）。不注册就直接 import，会静默失败；不传入插件列表，@plugin 规则会被忽略。
- 插件对象必须有
install(less, pluginManager)方法，且不能是箭头函数（需访问this） -
@plugin必须写在顶层作用域，不能嵌套在@media、.mixin()或条件规则里 - 插件 JS 文件路径需相对于当前 Less 文件（非 Node.js 模块路径），比如
@plugin "utils/plugin.js";表示同目录下的plugin.js - Node.js 环境下，插件文件必须导出一个函数，且该函数返回的对象要满足 Less 插件接口
@plugin 规则的解析时机和限制
@plugin 不是 CSS @rule，它只在编译前被 Less 解析器识别并触发插件加载，不会输出到 CSS 中。一旦解析失败（如路径不存在、语法错误、插件无 install 方法），Less 会抛出 PluginError，而不是跳过。
- 同一个插件多次
@plugin只会执行一次install，但每次都会尝试解析其 JS 内容（所以不要在里面写副作用逻辑） - 插件无法访问当前文件的变量作用域，只能通过
pluginManager.addVisitor()或addPostProcessor()等方式介入编译流程 - 不支持动态路径，
@plugin "prefix-" + $name + ".js"是非法语法，会报ParseError - 浏览器环境加载插件需确保 JS 已提前执行（比如 script 标签先于
less.js加载），否则less.plugins为空
常见插件功能：自定义函数 vs 访问器（Visitor）
插件扩展能力分两类：加函数（functions）适合封装计算逻辑；用 addVisitor 适合改 AST（比如自动补全单位、重写选择器）。选错类型会导致功能不可用。
- 自定义函数必须注册在
less.functions.functionRegistry.add()上，参数名区分大小写，返回值必须是new less.tree.Dimension()、new less.tree.Color()等 Less 内置节点类型 - Visitor 的
visitDeclaration()等方法接收的是 AST 节点，修改后需返回新节点，原地修改无效（Less 使用不可变 AST） - 函数内不能调用
less.parse()或触发二次编译，会引发递归栈溢出 - Visitor 对性能影响明显，尤其在大型项目中，避免在
visitRuleset()里做深度遍历
调试插件时最常遇到的三个错误
插件问题往往不报具体行号，而是卡在编译阶段或输出异常 CSS。核心原因集中在环境、生命周期和类型匹配上。
立即学习“前端免费学习笔记（深入）”；
-
TypeError: Cannot read property 'add' of undefined：说明less实例未正确传入插件的install，检查是否漏了less.plugins.push(myPlugin)或未在options.plugins中传入 - CSS 输出含
undefined或空字符串：通常是函数返回了原始 JS 值（如return 12），没包装成less.tree.Dimension -
@plugin后样式未生效，且无报错：插件 JS 被加载但install没执行，大概率是插件文件未导出函数，或导出方式不符合 CommonJS/UMD 规范（浏览器环境尤其敏感）
module.exports，浏览器用 window.myPlugin = function(){}），混用就会加载成功但 install 失败。 
