前端工程化 / 系统课时

配置压缩与 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。非正式模式关闭压缩,便于比较构建结果;实际团队也可以只保留生产分支。

ts
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 注释。

构建并验证产物

在项目根目录执行构建:

bash
npm run build

预期输出:

text
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>

文件名、模块数和耗时会随项目变化。继续检查映射文件:

bash
find dist -type f -name '*.map' -print

预期输出:

text
dist/assets/index-<ID>.js.map

实际项目可能输出多个 .map 文件。若使用 hidden,还应搜索构建后的 JavaScript,确认没有公开映射引用:

bash
grep -R "sourceMappingURL" dist/assets --include='*.js'

预期输出:

text
无输出

部署与排错边界

隐藏 Source Map 不是加密文件;只要 .map 被部署到公开目录,仍可能被直接下载。推荐流程是先把 .map 上传到错误监控平台,并使用与发布版本一致的 release 标识,再从公开静态目录删除映射文件。

若线上堆栈无法还原,按“发布版本是否一致、映射文件是否上传、文件名与路径是否匹配”的顺序检查。若选择 terser 后构建提示找不到包,需要先安装 terser;若大型项目构建时间明显增加,可暂时关闭 reportCompressedSize,区分是压缩、Source Map 还是 gzip 体积统计造成的耗时。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置压缩与 Source Map

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通