output.cleanDistPath#

• 类型： boolean | 'auto'
• 默认值： 'auto'

是否在构建开始前清理产物目录下的所有文件（产物目录默认为 dist）。

默认行为#

output.cleanDistPath 的默认值为 'auto'。如果产物目录是项目根路径的子目录，Rsbuild 会自动清空产物目录下的文件。

当 output.distPath.root 为外部目录，或等于项目根目录时，cleanDistPath 不会默认开启，这是为了避免误删其他目录的文件。

export default {
  output: {
    distPath: {
      root: '../../some-dir',
    },
  },
};

强制开关#

你可以把 cleanDistPath 设置为 true 来强制开启，也可以设置为 false 来强制关闭该行为。

export default {
  output: {
    cleanDistPath: true,
  },
};

条件判断#

如果你只需要在生产模式构建前清理文件，而在开发模式构建前不需要，那么可以配置为：

export default {
  output: {
    cleanDistPath: process.env.NODE_ENV === 'production',
  },
};