报错本质是Webpack未将~解析为node_modules别名，且less-loader未启用javascriptEnabled或配置错误。需根据less-loader版本正确设置lessOptions，安装less，检查loader顺序与exclude规则，并确认antd版本是否支持Less主题。
报错 ~antd/es/style/themes/index.less wasn't found，本质是 Webpack 没把 ~ 当成 node_modules 别名处理，不是 Less 语法或文件缺失问题。
less-loader 版本与 javascriptEnabled 配置不兼容
Ant Design 的 Less 文件里大量使用内联 JS（如 .bezierEasingMixin()），必须启用 JS 解析能力。但 less-loader@6+ 已废弃 javascriptEnabled 字段，改用 lessOptions 包裹：
- Webpack 4 / less-loader@5.x：仍可写
{ javascriptEnabled: true } - Webpack 5+ / less-loader@7.x+：必须写成
{ lessOptions: { javascriptEnabled: true } }，否则会报Invalid options object - 漏装
less本身也会触发该错误——less-loader只是 loader，不自带编译器，必须同时安装npm install less --save-dev
CssLoader 和 LessLoader 的执行顺序与 exclude 冲突
常见错误是 file-loader 或 url-loader 的 exclude 规则没排除 .less，导致 .less 文件被当成资源文件输出为 hash 路径，再交给 less-loader 时已不是源码（报 Unrecognised input）：
- 检查所有
rules中的exclude正则，确保包含less，例如：exclude: /\.(js|css|json|png|jpg|gif|less)$/ -
use数组顺序必须是倒序执行：应为['style-loader', 'css-loader', { loader: 'less-loader', options: {...} }]，不能把postcss-loader放在less-loader后面 - 如果用了
css-loader的importLoaders，要确认它指向的是less-loader而非其他 loader
~antd 路径别名未被 Less 解析器识别
~ 是 Webpack 的模块解析机制，但 less-loader 默认不走 Webpack 的 resolve.alias，需显式配置 paths 或 alias：
立即学习“前端免费学习笔记（深入）”；
- 最稳方案：在
less-loader的lessOptions中加paths：paths: [path.resolve(__dirname, 'node_modules')] - 或直接 alias
~antd：alias: { '~antd': path.resolve(__dirname, 'node_modules/antd') }，并确保该 alias 在 Webpackresolve.alias和lessOptions.paths中都生效 - 临时绕过：把
@import '~antd/es/style/themes/index.less';改成@import 'antd/es/style/themes/index.less';（去掉~），依赖 Webpack 的默认 node_modules 查找逻辑
Ant Design 主题路径在 v5 中已彻底变更
如果你用的是 antd@5.x，~antd/es/style/themes/index.less 这个路径根本不存在——v5 已移除 Less 主题系统，改用 CSS-in-JS + 动态主题。强行导入会 404：
- 确认
package.json中antd版本：antd@4.x才支持 Less 主题；antd@5.x必须迁移到ConfigProvider+themeAPI - 若项目混合了 v4/v5，注意
node_modules/antd实际解析的是哪个版本（检查软链或ls node_modules/antd/es/style/） - v5 用户若仍需 Less 支持，得降级回
antd@4.24.18（v4 最后一个维护版），或改用社区维护的@ant-design/pro-components中的兼容层
最容易被忽略的是：Webpack 的 resolve.alias 对 Less @import 无效，必须靠 less-loader 自己的 paths 或显式 alias 配置来透传——光配 Webpack 别名，Less 编译器根本看不到。
