output.sourceMap#

• 类型：

type SourceMap = {
  js?: Rspack.Configuration['devtool'];
  css?: boolean;
};

• 默认值：

const defaultSourceMap = {
  js: isDev ? 'cheap-module-source-map' : false,
  css: false,
};

用于设置是否生成 source map 文件，以及生成哪一种格式的 source map。

默认行为#

默认情况下，Rsbuild 的 source map 生成规则如下：

• 在开发模式构建时，会生成 JS 文件的 source map，便于进行开发调试；不会生成 CSS 文件的 source map。
• 在生产模式构建时，不会生成 JS 和 CSS 文件的 source map，以提供最佳的构建性能。

JS Source Map#

JS 文件的 source map 通过 sourceMap.js 来控制，可以传入 Rspack devtool 选项支持的所有 source map 格式，设置为 false 为关闭。

比如，如果你需要在所有模式生成高质量的 source map，可以设置为：

export default {
  output: {
    sourceMap: {
      js: 'source-map',
    },
  },
};

你也可以根据 NODE_ENV 来设置不同的 source map 格式：

export default {
  output: {
    sourceMap: {
      js:
        process.env.NODE_ENV === 'production'
          ? // 生产模式使用高质量的 source map 格式
            'source-map'
          : // 开发模式使用性能更好的 source map 格式
            'cheap-module-source-map',
    },
  },
};

CSS Source Map#

CSS 文件的 source map 通过 sourceMap.css 来控制，设置为 true 为开启，设置为 false 为关闭。

比如，如果需要生成 CSS 文件的 source map，可以设置为：

export default {
  output: {
    sourceMap: {
      css: true,
    },
  },
};