Less 的 @plugin 仅支持编译时 JavaScript 插件，要求 Node.js 模块路径、正确导出函数，且 webpack 中需通过 less-loader 的 plugins 选项配置，而非 @plugin 语句。
@plugin 指令在 Less 中只支持加载 JavaScript 插件（即编译时插件），不支持“CSS 插件”——根本不存在所谓“自定义 CSS 插件”的概念。如果你看到 @plugin 报错或静默失效，大概率是因为误用了语法、路径错误，或混淆了插件类型。
为什么 @plugin 总是报错或没反应？
Less 的 @plugin 是编译器级指令，必须在 Less 编译阶段由 lessc 或构建工具（如 Webpack + less-loader）加载 JS 模块，不是运行时注入样式的行为。
- 常见错误现象：
Cannot find module 'xxx'、Plugin not found、或完全无报错但函数/变量未生效 - 根本原因：路径写成相对 URL（如
@plugin "plugins/my-plugin.js"），但 Less 要求的是 Node.js 模块路径（支持node_modules解析或绝对路径） - 路径必须可被
require()加载：不能是./开头的相对路径（除非你用--plugin-path显式指定目录），也不能是浏览器中能访问的 URL - 插件文件必须导出一个函数，且该函数接收
less实例作为参数（如module.exports = function(less) { ... }）
Webpack 环境下 @plugin 为何完全不生效？
less-loader 默认不启用 @plugin 支持，它只处理 less 本身的语法解析，不会主动执行插件注册逻辑。
- less-loader v7+ 已移除对
@plugin的支持；v6 及更早版本也需显式配置javascriptEnabled: true才可能部分兼容（但不稳定） - 正确做法是绕过
@plugin，改用 less-loader 的plugins选项传入 JS 插件实例 - 示例（vue.config.js）：
css: { loaderOptions: { less: { additionalData: `@import "@/styles/vars.less";`, plugins: [require('less-plugin-functions')] } } } - 注意：插件必须已安装为依赖（
npm install less-plugin-functions --save-dev），且不能依赖@plugin语句触发
less-plugin-functions 为什么用 @plugin 加载失败？
这个插件本身不支持通过 @plugin 加载——它的设计就是命令行或构建工具 API 集成，不是为 @plugin 指令编写的。
立即学习“前端免费学习笔记（深入）”；
- 官方用法是
lessc --functions my.less > out.css，而非在 .less 文件里写@plugin "less-plugin-functions" - 如果你强行在 .less 中写
@plugin "less-plugin-functions"，Less 会尝试加载一个叫less-plugin-functions.js的文件，但该包没有导出符合插件签名的函数，直接崩溃 - 真正可用的插件（如
less-plugin-clean-css）也仅限命令行场景，且需配合lessc使用，不适用于浏览器或 webpack
真正容易被忽略的点：Less 的 @plugin 不是“插件市场”，它不解析 npm 包名、不支持自动安装、不处理 peerDependencies，甚至不校验导出格式。一旦路径或导出结构不对，就静默失败——连 warning 都不会抛。别把它当 Webpack plugin 用。
