CC 4.0 协议声明

本节内容派生于以下链接指向的内容 ,并遵守 CC BY 4.0 许可证的规定。

以下内容如果没有特殊声明,可以认为都是基于原内容的修改和删减后的结果。

Status

打包信息:该选项可用于生成分析模块的依赖关系图,以及优化编译速度的打包信息。

输出打包信息的 JSON 文件
  • 使用 @rspack/clirspack build --json stats.json
  • 通过 Rspack 的 Node.js API,stats.toJson(options)stats.toString(options)
  • 类型: boolean | string | Object
  • 默认值: true

预设(Stats Presets)

预设 描述
'normal' (true) 按照 stats options 的默认值输出
'none' (false) 不输出任何信息
'verbose' 输出所有信息
'errors-only' 只输出错误相关信息
'errors-warnings' 只输出错误和警告相关信息

详细选项(Stats Options)

可以指定具体哪些打包信息进行输出,以下所有字段都是可选(optional)的。

stats.assets

  • 类型: boolean
  • 默认值: true

是否输出产物相关信息。

stats.chunks

  • 类型: boolean
  • 默认值: true

是否输出 Chunk 相关信息。

stats.modules

  • 类型: boolean
  • 默认值: true

是否输出模块相关信息

stats.entrypoints

  • 类型: boolean
  • 默认值: true

是否输出入口 ChunkGroup 相关信息。

stats.reasons

  • 类型: boolean
  • 默认值: true

是否输出模块被引入的原因。

stats.hash

  • 类型: boolean
  • 默认值: true

是否输出本次构建的 hash。

stats.errors

  • 类型: boolean
  • 默认值: true

是否输出本次构建产生的错误。

stats.errorsCount

  • 类型: boolean
  • 默认值: true

是否输出本次构建产生的错误的数量。

stats.warnings

  • 类型: boolean
  • 默认值: true

是否输出本次构建产生的警告。

stats.warningsCount

  • 类型: boolean
  • 默认值: true

是否输出本次构建产生的警告的数量。

stats.all

  • 类型: boolean
  • 默认值: undefined

控制所有 stats options 是否输出。

stats.preset

  • 类型: boolean
  • 默认值: undefined

按照预设值进行输出。

扩展打包信息输出行为

如果你想使用预设的输出行为,但又想多输出或少输出个别字段,可以在指定 preset 或 all 之后对字段的输出行为进行自定义。

举例来说,只输出错误和模块被引入的原因:

rspack.config.js
module.exports = {
  // ...
  stats: {
    preset: 'errors-only',
    reasons: true,
  },
};