在 vite 项目中配置 sourcemap,核心是修改 vite.config.js 中的 build 选项。将 build.sourcemap 设置为 true 即可生成源码映射文件。默认情况下,vite 在生产环境不生成 sourcemap,开启后构建产物会包含对应的 .map 文件,便于调试。

如何区分开发环境与生产环境的 SourceMap 策略?
通过判断环境变量 process.env.NODE_ENV 的值来决定是否生成 SourceMap。开发环境下通常设为 true 以支持热更新和断点调试;生产环境下建议设为 false 或按需开启,以避免泄露源码并减小包体积。

import { defineConfig } from 'vite';
export default defineConfig({
build: {
sourcemap: process.env.NODE_ENV === 'development' ? true : false,
},
});上述代码中,当运行 npm run dev 时,NODE_ENV 为 development,SourceMap 开启;运行 npm run build 时,NODE_ENV 为 production,SourceMap 关闭。开发者可根据实际需求调整此逻辑,例如始终开启或在特定条件下开启。
立即学习“Java免费学习笔记(深入)”;
为什么生产环境需要谨慎开启 SourceMap?
生产环境开启 SourceMap 会增加构建产物的体积,因为每个 JS/CSS 文件都会附带一个对应的 .map 文件。此外,SourceMap 包含了原始源码信息,可能带来安全风险。因此,除非有明确的调试需求(如监控错误堆栈还原),否则不建议在生产环境全局开启。

import { defineConfig } from 'vite';
export default defineConfig({
build: {
sourcemap: process.env.NODE_ENV === 'production' && process.env.RELEASE_DEBUG === 'true',
},
});该配置示例展示了更精细的控制:仅在 NODE_ENV 为 production 且显式设置 RELEASE_DEBUG=true 时才生成 SourceMap。这种方式允许在发布特定版本时临时开启调试能力,而不会影响常规生产构建的性能和安全。
SourceMap 对错误堆栈追踪有何具体影响?
当 SourceMap 开启时,浏览器控制台和错误监控系统(如 Sentry)能够将压缩后的代码行号映射回原始源码位置。这意味着错误堆栈显示的是原始文件名、行号和列号,极大提升了排查问题的效率。若未开启,堆栈将指向混淆后的代码位置,难以定位。


















