Chrome DevTools 点不到 .scss 文件，根本原因是 sourcemap 未真正生成或加载失败：Dart Sass CLI 默认关闭 sourcemap，Webpack/Vite 常覆盖配置；需检查 CSS 文件末尾是否有 sourceMappingURL 注释、.map 文件能否被浏览器直接访问、Sources 面板是否显示 .scss 文件名。
Chrome DevTools 点不到 .scss 文件？先确认 sourcemap 是否真生效
不是加了 --sourcemap 就算开启——Dart Sass CLI 默认关闭 sourcemap，Webpack/Vite 里也常被覆盖或设为 false。浏览器里点样式跳转失败，第一反应不是“配置错了”，而是“根本没生成映射”。
检查三件事：
- 输出的
.css文件末尾是否有/*# sourceMappingURL=xxx.css.map */注释；没有？说明 sourcemap 没启用 - 对应
.css.map文件是否存在，且能通过浏览器直接访问（比如打开http://localhost:3000/css/index.css.map能看到 JSON） - DevTools → Sources 面板里能否展开 “sass” 或 “sources” 节点，看到你的
.scss文件名；看不到？多半是sources字段路径解析失败
sourcemap 的 sources 路径为什么总指向错地方？
映射文件里 sources 字段存的是相对路径，但它是相对于 sourceRoot（或 CSS 文件所在 URL）解析的。常见错误是它写成了 ["../src/scss/button.scss"]，而开发服务器只暴露了 /src/ 下的文件，../ 就越界了。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- CLI 编译时加
--source-map-include-sources：把原始 SCSS 内容直接塞进.map，彻底绕过路径查找（适合小项目） - Webpack 中确保
sass-loader使用dart-sass（别用已弃用的node-sass），并配sourceMap: true和sourceMapRoot: '' - Vite 用户注意：
css.devSourcemap: true只控制 CSS 层链，Sass 编译还得显式设css.preprocessorOptions.sass.sourceMap: true - 生成后手动打开
.css.map，检查sources值是否全为项目内可访问的相对路径（如["button.scss", "mixins/_reset.scss"]），绝不能出现/Users/xxx/...或../../outside-project/
@use 导致跳转行号偏移，怎么定位真正编辑的文件？
Dart Sass 的 @use 会让 sourcemap 把所有依赖模块“扁平化”进一个逻辑上下文，你点样式时跳转的位置，可能是被 @use 进来的 mixin 或变量定义处，而不是你正在写的那个 .scss 文件。
这不是 bug，是设计行为。调试时容易误判：
- 右键 DevTools Sources 里的
.scss文件 → “Blackbox Content Script”，再刷新页面，跳转会退回到上一级映射（比如从_mixins.scss退到main.scss） - 避免深度嵌套：单个文件里
@use太多、又混用@import，会加剧行号漂移；优先用@use，但控制层级 - PostCSS 插件（如
autoprefixer）若插在 Sass 后，必须开启sourceMap: true，否则它改写 CSS 行号却不更新映射，跳转必然错位
HTTPS 开发环境 sourcemap 加载失败？别忽略证书和响应头
用自签名 SSL 证书跑本地服务（比如 https://localhost:3000）时，Chrome 会拒绝加载不安全来源的 sourcemap，即使路径完全正确，也会静默失败。
验证和修复方式：
- 打开 DevTools → Network 标签页，筛选
.map，看请求状态是不是net::ERR_INSECURE_RESPONSE - 临时切到 HTTP 协议测试，如果 map 立刻可加载，基本锁定是证书问题
- 开发服务器响应头里加上
Cache-Control: no-cache，避免旧的、带错误路径的.map被缓存复用 - 某些代理（如 nginx 本地转发）会 strip 掉
SourceMap相关响应头，需显式透传X-SourceMap或允许.map后缀
最隐蔽的坑是：路径、配置、工具链全对，但浏览器压根没发起 .map 请求——这时候该去 Network 里找证书或缓存线索，而不是继续调 sourcemap 配置。
