Less编译正确生成sourceMap需显式开启：lessc命令须加--source-map及--source-map-basepath，Webpack中less-loader必须配置sourceMap: true，且css-loader、MiniCssExtractPlugin等需协同开启并校准路径。
Less 编译时如何正确生成 sourceMap？
Less 本身不内置 source map 支持，必须通过编译器（如 lessc CLI 或构建工具）显式开启。关键不是加个参数就完事，而是要确保输出路径、内容嵌入方式与浏览器加载行为匹配。
- 使用
lessc命令行时，必须同时指定--source-map和--source-map-basepath（否则 .map 文件里的sources路径容易指向错误的 Less 文件位置） - 若用 Webpack +
less-loader，需在 loader 配置中启用sourceMap: true，且确保devtool不为eval类（如eval-source-map会覆盖 Less 的 map） - Vite 默认启用 CSS source map，但仅当
build.cssCodeSplit为true且未禁用build.sourcemap时才生效
lessc --source-map=style.css.map --source-map-basepath=. --source-map-rootpath=./src/ styles.less style.css
浏览器里看不到 Less 文件？检查 sourcesContent 和路径映射
生成的 style.css.map 文件里，sources 字段是相对路径，sourcesContent 才决定浏览器能否直接显示原始 Less 内容。如果只看到空格或“could not load content”，大概率是：
-
lessc默认不内联源码，需加--source-map-inline或手动设置--source-map-include-sources - Webpack 中
less-loader的sourceMap: true默认不包含sourcesContent，得配合css-loader的sourceMap: true和devtool: 'source-map'才完整 - 浏览器开发者工具中，Less 文件出现在
webpack://或file://下，取决于构建时的sourceMapRoot配置；若显示为<a href="https://www.php.cn/link/af65037895abdcc6042b4bf0b9f786f6">https://www.php.cn/link/af65037895abdcc6042b4bf0b9f786f6</a>，说明sources是空字符串或路径解析失败
调试时断点不生效？确认 CSS 层级和变量作用域限制
Less 的 source map 只能映射到声明语句（如 .btn { color: @primary; }），无法在运行时调试变量计算过程或 mixin 展开逻辑：
- 断点只能打在生成后的 CSS 规则上，不能像 JS 那样单步执行
.mixin()内部 -
@variable的值不会显示在 debugger 中，浏览器只看到最终计算出的 CSS 值（如color: #007bff） - 嵌套规则（
&:hover）会正确映射回 Less 中对应行，但若用了extend或merge，source map 可能指向多个源文件，造成跳转混乱 - 修改 Less 文件后热更新（HMR）若未刷新 source map，旧的 .map 文件仍被缓存，需清空浏览器缓存或禁用缓存（Network → Disable cache）
Webpack + less-loader 调试失败的常见配置陷阱
最常踩的坑不是 Less 本身，而是 loader 链路中断：
立即学习“前端免费学习笔记（深入）”；
-
less-loader后面接了css-loader，但后者没开sourceMap: true，会导致 map 丢失 -
MiniCssExtractPlugin在生产模式下默认关闭 source map，开发时需显式设options.sourceMap = true -
postcss-loader若在 less-loader 之后，也必须启用sourceMap: true，否则 PostCSS 插件（如 autoprefixer）会破坏原始映射 - 某些 IDE（如 VS Code）的 CSS 调试插件不识别 Less source map，只能依赖浏览器 DevTools 的 Styles 面板中的 “original source” 链接
Less 的 source map 本质是静态映射，它不追踪变量求值、条件编译或 JavaScript 注入的动态样式。真正卡住调试的，往往不是 map 没生成，而是构建链路中某一层悄悄丢掉了 sourcesContent 或重写了 sources 字段。
