Less sourcemap失效90%是浏览器未加载有效映射，需先验证三件事：CSS末尾是否有合法sourceMappingURL注释、.map文件能否被直接访问且sources非空、Sources面板是否显示.less文件名；再检查less-loader、css-loader及MiniCssExtractPlugin的sourceMap配置与路径协同。
Less编译后source map失效，90%不是没生成，而是浏览器根本没加载到有效映射——先验证三件事，再调配置。
检查CSS末尾是否有合法sourceMappingURL注释
浏览器只认 CSS 文件最后一行的 /*# sourceMappingURL=xxx.css.map */，且必须是纯注释、无空行、无其他字符。手动加或构建工具覆盖都容易出错。
- 用
tail -n 1 dist/main.css（Linux/macOS）或记事本末尾查看，确认存在该注释 - 如果注释里路径是
../maps/main.css.map，但开发服务器只暴露/css/目录，浏览器就 404 —— 路径必须能被直接访问（比如http://localhost:3000/css/main.css.map） - Webpack/Vite 等工具通常自动注入，但如果用了自定义 PostCSS 插件或
lightningcss，可能删掉了这行；检查构建日志是否含“Generated source map for”
验证.css.map文件本身是否有效
空的 .map 文件（如 {"version":3,"sources":[],"mappings":"","file":"style.css"}）说明编译器压根没建立映射，不是路径问题，是开关没打开。
- 用浏览器直接打开
.css.mapURL，看是否返回合法 JSON，sources字段是否非空（例如["button.less", "mixins/_reset.less"]） - Less 4.0+ 默认关闭 sourcemap，命令行编译必须显式加
--source-map参数，且要放在输入输出路径之前：lessc --source-map src/button.less dist/button.css - Webpack 中
less-loader必须显式设sourceMap: true，仅靠devtool配置完全无效 —— 它只影响 JS 层
确认sources字段里的路径能否被浏览器访问
看到 .css.map 且内容正常，但 Sources 面板里没有 .less 文件？多半是 sources 里的路径解析失败。
立即学习“前端免费学习笔记（深入）”；
- 检查
.map文件中sources值：出现"/Users/xxx/project/src/button.less"（绝对路径）或"../../src/button.less"（越界相对路径）就危险，浏览器无法定位 - Webpack 中需配
mini-css-extract-plugin的publicPath: ''，否则它默认写成http://localhost:3000/dist/main.css.map这类绝对 URL - 用
curl -I http://localhost:3000/src/button.less测试每个sources路径是否返回 200；404 就说明开发服务器没正确 serve 源文件目录
Webpack 中 less-loader、css-loader、MiniCssExtractPlugin 必须协同开启sourceMap
漏掉任意一环，映射链就断裂：less-loader 不开 → 没原始映射；css-loader 不开 → 吃掉上游 map；MiniCssExtractPlugin 不设 publicPath: '' → 路径写死导致 404。
-
less-loader配置必须含{ loader: 'less-loader', options: { sourceMap: true } } -
css-loader显式写{ sourceMap: true }，不能依赖继承 - 若用
MiniCssExtractPlugin，其 loader 的options.publicPath必须设为空字符串''，否则sourceMappingURL会带绝对前缀 - 开发环境推荐
devtool: 'eval-cheap-module-source-map'+ 全链sourceMap: true；生产环境抽离 CSS 时，devtool必须为source-map，因为MiniCssExtractPlugin不支持 eval 类
最常被忽略的是：即使所有配置都对，浏览器也可能因缓存加载了旧 CSS，而它末尾的 sourceMappingURL 指向一个早已被构建脚本删掉的旧 .map 文件 —— 刷新时强制清空缓存，或禁用 DevTools 的 “Disable cache” 选项再试。
