简体中文

performance.buildCache

类型：

type BuildCacheConfig =
  | boolean
  | {
      cacheDirectory?: string;
      cacheDigest?: Array<string | undefined>;
      buildDependencies?: string[];
    };

默认值： false
版本： >= 1.2.5

用于启用或配置持久化构建缓存。

当启用时，Rspack 会在缓存目录中存储构建快照。在后续的构建中，如果命中缓存，Rspack 可以重用缓存的结果，而不是从头开始重新构建，这可以显著减少构建时间。

TIP

Rspack 的持久化缓存处于实验性阶段，可能会在未来的版本中发生变化。

启用缓存

设置 performance.buildCache 为 true 将启用持久化构建缓存：

rsbuild.config.ts

export default defineConfig({
  performance: {
    buildCache: true,
  },
});

或者仅在开发模式下启用缓存：

rsbuild.config.ts

const isDev = process.env.NODE_ENV === 'development';

export default defineConfig({
  performance: {
    buildCache: isDev,
  },
});

选项

cacheDirectory

类型： string
默认值： node_modules/.cache

用于设置缓存文件的输出目录。

rsbuild.config.ts

import path from 'node:path';

export default defineConfig({
  performance: {
    buildCache: {
      cacheDirectory: path.resolve(__dirname, 'node_modules/.my-cache'),
    },
  },
});

cacheDigest

类型： Array<string | undefined>
默认值： undefined

添加额外的缓存摘要，当数组中的任何值发生变化时，之前的构建缓存就会失效。

cacheDigest 可以用于添加一些会对构建结果产生影响的变量，例如 process.env.SOME_ENV。

rsbuild.config.ts

export default defineConfig({
  performance: {
    buildCache: {
      cacheDigest: [process.env.SOME_ENV],
    },
  },
});

buildDependencies

类型： string[]
默认值： undefined

buildDependencies 是一个包含构建依赖的文件数组，Rspack 将使用其中每个文件的哈希值来判断持久化缓存是否失效。

Rsbuild 会将以下配置文件作为默认的构建依赖：

package.json
tsconfig.json
rsbuild.config.*
.browserslistrc
tailwindcss.config.*

当你添加其他构建依赖时，Rsbuild 会将这些自定义依赖与默认依赖合并，并传递给 Rspack。

rsbuild.config.ts

export default defineConfig({
  performance: {
    buildCache: {
      buildDependencies: [__filename],
    },
  },
});

performance.buildCache#

启用缓存#

选项#

cacheDirectory#

cacheDigest#

buildDependencies#

performance.buildCache

启用缓存

选项

cacheDirectory

cacheDigest

buildDependencies