.NET6.0 Web项目报.MixinName is undefined、Less mixin未定义错误求解

云原生阿岚

2026-8-30

.NET 6 项目Less编译提示Mixin未定义修复方案

问题根因

报错来自Less打包逻辑配置错误。你当前使用的AddLessBundle方法传入了通配符css/**/*.less，会将匹配到的所有Less文件作为独立入口单独编译。但你项目中以下划线开头的Less文件（包括存mixin的_mixins.less）都是作为局部依赖被styles.less导入的，本身不包含完整的依赖引入上下文，单独编译时自然找不到提前定义的mixin，触发报错。

修复步骤

修改Startup.cs中的WebOptimizer配置，移除通配符，仅将全局入口styles.less设为打包入口，打包器会自动递归处理所有@import引入的依赖文件，不会遗漏样式：
```
services.AddWebOptimizer(pipe =>
{
    pipe.AddLessBundle("/css/styles.min.css", "css/styles.less")
        .MinifyCss();
});
```
检查所有Less文件中@import的相对路径是否正确：路径是相对于当前写import语句的Less文件的位置计算，不是相对于项目根目录或styles.less的位置。如果_mixins.less和styles.less在同目录，直接写@import "_mixins.less";即可，不需要加../前缀。
检查styles.less中的导入顺序：必须先导入_mixins.less文件，再导入其他调用mixin的业务Less文件，顺序颠倒也会触发mixin未定义错误。
校验mixin名称大小写：Less对标识符大小写敏感，确认定义mixin的名称、调用时写的名称完全一致，不要出现定义用.mixin-name、调用写成.MixinName的拼写问题。