必须用@import (less) "path.css"强制解析为Less，或直接导入源文件@import "path.less"；因默认@import "xxx.css"仅原样输出，不编译内容，无法复用变量或mixin。
@import "node_modules/xxx.css" 直接报错
Less 默认把 @import "xxx.css" 当作原生 CSS 导入，只做路径解析、不编译内容，也不会自动加 @import 到输出结果里——但如果你的 xxx.css 里其实含 Less 语法（比如某些 UI 库的源码），或者你希望它被当作 Less 处理（例如要复用其中的变量），就会失败。
常见错误现象：
- 控制台报
File not found: node_modules/xxx.css（路径没解析对） - 样式没生效，检查编译后 CSS 发现该
@import消失了 - 如果 xxx.css 实际是 xxx.less 的别名（如 antd 的
index.css其实由 Less 编译而来），直接导入会跳过所有变量逻辑
正确做法是显式声明解析方式：
- 用
@import (less) "node_modules/xxx/xxx.css";强制以 Less 方式读取（前提是文件内容确实是 Less 可解析的） - 更稳妥的是直接导入源文件：
@import "node_modules/xxx/xxx.less";（推荐，避免歧义） - 如果路径太长，可在 Webpack 或 Vite 中配置
paths或别名，然后写@import "~xxx/xxx.less";（注意：此~是 less-loader 扩展，原生 lessc 不支持）
为什么 @import "antd/lib/button/style/index.css" 不起作用
Ant Design 的 index.css 是构建产物，不是源码。它本身不含变量或 Mixin，只是纯 CSS；而你真正需要的是它的 Less 源文件（index.less），里面才定义了 @primary-color 等可定制入口。
立即学习“前端免费学习笔记（深入）”；
直接导入 CSS 文件会导致两个问题：
- 无法覆盖变量（
@primary-color: red;在导入前写也没用） - Webpack / Vite 构建时可能因规则顺序错乱，让 css-loader 先于 less-loader 处理该路径，导致
javascriptEnabled等关键选项失效 - 如果项目启用了 CSS Modules，还可能把 antd 样式意外模块化，类名全变成
ant-btn__xxx这种哈希格式，破坏全局样式预期
所以必须改用：
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
@import "node_modules/antd/lib/button/style/index.less";- 并确保构建工具中处理
.less的规则启用javascriptEnabled: true（antd 内部用了内联 JS 计算颜色） - 若用 CRA，需通过
craco或 Eject 修改 less-loader 配置；Vite 默认支持，但也要确认没被插件干扰
路径解析被 node_modules 干扰怎么办
less-loader 默认按 node_modules → 当前目录 → paths 顺序查找 @import，这意味着如果你写了 @import "utils/mixins";，而恰好有个 npm 包叫 utils，Less 就会误引它，而不是你本地的 src/styles/utils/mixins.less。
解决方法很直接：
- 所有项目内导入统一用相对路径：
@import "./mixins";或带后缀：@import "mixins.less"; - 在 Webpack 的 less-loader
options中显式设置paths，且把它放在node_modules前面：
options: {
paths: [path.resolve(__dirname, 'src/styles')],
javascriptEnabled: true
}
Vite 用户注意：vite.config.ts 中可通过 css.preprocessorOptions.less.paths 设置，效果相同。
reference 导入 + node_modules 样式 = 静默失效
当对来自 node_modules 的样式文件使用 @import (reference)，比如：
@import (reference) "node_modules/antd/lib/style/themes/default.less";
Less 会加载它、提取变量和 Mixin，但不输出任何 CSS 规则——这本身没错。但问题在于：很多组件库（包括 antd）的样式文件之间有隐式依赖，比如 button.less 依赖 default.less 中的变量，但又没显式 @import 它。一旦你用 (reference) 提前“预加载”了 default.less，Less 编译器可能认为变量已存在，后续同名变量定义被忽略，最终样式计算出错。
真实踩坑点：
- 开发环境热更新下可能正常，生产构建时变量作用域合并异常
- 没有报错，只有部分按钮背景色变灰、边框消失等“轻微失真”
- 查不到源头，因为控制台和编译日志都安静得可怕
建议策略：
- 不要对第三方库的 Less 文件用
(reference)，除非你完全掌控其源码结构 - 自定义主题变量应单独维护一个
theme.less，用@import (reference)导入它，再在各组件样式前显式@import主题文件 - 验证是否生效：用
lessc --verbose编译，grep 关键变量名，看它是否出现在最终 AST 中
