Less编译报错找不到对应.less行号，根本原因是SourceMap未正确生成或加载：Less 4.0+默认关闭，需显式加--source-map参数；Webpack中less-loader和css-loader均须开启sourceMap: true；Vue CLI还需设置javascriptEnabled: true；同时需确保.map文件路径可访问、无缓存干扰及@import导致的行号偏移。
Less编译报错但找不到对应.less行号？先确认SourceMap是否真生效
浏览器里点CSS规则跳不到.less文件，或DevTools显示“no sources”，不是工具坏了，而是SourceMap根本没被正确生成或加载。Less 4.0+ 默认关闭SourceMap，漏掉--source-map参数就等于没配。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 命令行编译必须显式加：
lessc --source-map=styles.css.map styles.less styles.css - Webpack用户检查
less-loader的sourceMap: true，同时确保css-loader也开了sourceMap: true（style-loader默认不干预，不用动） - Vue CLI项目需在
vue.config.js中透传：css.loaderOptions.less.javascriptEnabled = true，否则@import解析失败会导致SourceMap断链
SourceMap指向404？检查.map文件里的sources路径是否可访问
浏览器控制台报404，不是服务器挂了，是styles.css.map里sources字段写的路径压根不在Web服务托管范围内。比如默认生成["../src/variables.less"]，但生产环境只部署/dist/下的资源，../src/自然打不开。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 用
lessc --source-map-include-names --source-map-rootpath=/static/ styles.less styles.css，让sources变成["/static/src/variables.less"] - Webpack中设
output.devtoolModuleFilenameTemplate: "[absolute-resource-path]"，避免默认webpack://协议被拦截 - 上线前手动
curl https://yoursite.com/styles.css.map，确认响应体中每个sources路径都能curl -I通
改了变量但CSS没变，SourceMap还跳到旧文件？缓存链路断了
不是编译工具失灵，是缓存干扰了映射关系：CSS文件内容更新了，但末尾的sourceMappingURL注释没同步，或浏览器加载了旧CSS，它带的旧注释会去拉旧.map，而那个文件可能早已被构建脚本删掉。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 硬刷前务必打开DevTools的
Disable cache选项 - 检查
styles.css末尾注释是否严格匹配：/*# sourceMappingURL=styles.css.map */（少空格、错字符都会失效） - CDN或Nginx配置中，确保
.map文件未被Cache-Control: no-store误拦，且与CSS文件缓存策略一致
为什么Chrome里能看见.less文件却跳错行？@import导致的行号偏移
Less中@import是文本拼接，不是模块隔离。如果A.less里@import "mixins.less"，而mixins.less有50行，那A中第10行实际对应编译后CSS的第60行——SourceMap按拼接后总行数映射，但开发者工具常按原始文件行号粗略跳转，造成偏差。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 避免在
@import前写大量空行或注释，减少行号漂移 - 把高频复用的
@import统一提到文件顶部，保持导入顺序稳定 - 调试时优先看
styles.css.map里mappings字段的VLQ编码是否连续，不连续说明某次@import内容被截断或解析异常
真正卡住人的从来不是SourceMap开关，而是编译路径、部署路径、缓存路径这三者之间差了一个/static/或一次硬刷。
