前端工程化 / 系统课时
配置压缩与 Source Map
配置压缩与 Source Map
本课解决生产构建中“文件要小、构建要快、线上错误还要能定位”的冲突。完成后,你将得到一套适合常规 Web 应用的压缩与隐藏 Source Map 配置,并能验证产物是否符合部署要求。
学习目标
- 区分 JavaScript 压缩、CSS 压缩与 Source Map 的独立职责
- 根据构建速度、产物体积和诊断要求选择配置
- 验证压缩结果,并避免 Source Map 被公开访问
先确定上线目标
压缩器负责删除冗余语法、缩短标识符并优化表达式;Source Map 负责把压缩后的行列位置映射回源文件。二者可以同时启用,不应把“便于排错”等同于“关闭压缩”。
在当前 Vite 8 客户端构建中,JavaScript 默认使用 Oxc 压缩,CSS 默认使用 Lightning CSS,生产 Source Map 默认关闭。大多数项目先沿用默认压缩器,再按错误监控方案决定是否生成 Source Map。
| 选项 | 适用选择 | 主要影响 |
|---|---|---|
build.minify: 'oxc' |
常规生产构建 | 构建快,压缩率适合多数应用 |
build.minify: 'terser' |
需要 Terser 特定选项 | 需安装 terser,构建通常更慢 |
build.cssMinify: 'lightningcss' |
常规 CSS 压缩 | 与 JavaScript 压缩器可独立配置 |
build.sourcemap: false |
不需要线上源码映射 | 产物最简单,但压缩栈难以还原 |
build.sourcemap: true |
服务器允许访问 .map |
生成独立映射并在产物中写入引用 |
build.sourcemap: 'hidden' |
上传到错误监控平台 | 生成映射,但不在构建文件中暴露引用 |
build.sourcemap: 'inline' |
临时诊断 | 映射嵌入产物,通常不适合正式发布 |
配置生产构建
下面的配置让正式构建使用 Oxc 和 Lightning CSS,并生成隐藏 Source Map。非正式模式关闭压缩,便于比较构建结果;实际团队也可以只保留生产分支。
import { defineConfig } from 'vite'
export default defineConfig(({ mode }) => {
const isProduction = mode === 'production'
return {
build: {
// 正式环境保留压缩,其他模式便于查看可读产物。
minify: isProduction ? 'oxc' : false,
cssMinify: isProduction ? 'lightningcss' : false,
// hidden 会生成映射文件,但不会向浏览器公开映射地址。
sourcemap: isProduction ? 'hidden' : true,
reportCompressedSize: true,
},
}
})配置生效行为:执行生产构建时,JavaScript 与 CSS 会分别压缩,dist 中会出现独立的 .map 文件,而生成的 JavaScript 不包含 sourceMappingURL 注释。
构建并验证产物
在项目根目录执行构建:
npm run build预期输出:
vite v<VERSION> building for production...
✓ <ID> modules transformed.
dist/index.html
dist/assets/index-<ID>.css
dist/assets/index-<ID>.js
✓ built in <TIME>文件名、模块数和耗时会随项目变化。继续检查映射文件:
find dist -type f -name '*.map' -print预期输出:
dist/assets/index-<ID>.js.map实际项目可能输出多个 .map 文件。若使用 hidden,还应搜索构建后的 JavaScript,确认没有公开映射引用:
grep -R "sourceMappingURL" dist/assets --include='*.js'预期输出:
无输出部署与排错边界
隐藏 Source Map 不是加密文件;只要 .map 被部署到公开目录,仍可能被直接下载。推荐流程是先把 .map 上传到错误监控平台,并使用与发布版本一致的 release 标识,再从公开静态目录删除映射文件。
若线上堆栈无法还原,按“发布版本是否一致、映射文件是否上传、文件名与路径是否匹配”的顺序检查。若选择 terser 后构建提示找不到包,需要先安装 terser;若大型项目构建时间明显增加,可暂时关闭 reportCompressedSize,区分是压缩、Source Map 还是 gzip 体积统计造成的耗时。