功能类问题#

如何配置组件库按需引入？#

如果需要配置组件库的按需引入，你可以通过 source.transformImport 配置，这个配置的能力等价于 babel-plugin-import。

export default {
  source: {
    transformImport: [
      {
        libraryName: 'my-components',
        libraryDirectory: 'es',
        style: true,
      },
    ],
  },
};

如何在编译过程中进行 ESLint 代码校验？#

出于编译性能的考虑，Rsbuild 默认不会在编译过程中进行 ESLint 校验，如果你需要该功能，可以使用 Rsbuild 的 ESLint 插件。

如何配置静态资源的 CDN 路径？#

如果需要将 JS、CSS 等静态资源上传到 CDN 使用，那么可以通过 output.assetPrefix 配置来设置静态资源的 URL 前缀。

export default {
  output: {
    assetPrefix: 'https://cdn.example.com/assets/',
  },
};

如何移除代码中的 console？#

在生产模式构建时，我们可以移除代码中的 console，从而避免开发模式的日志被输出到生产模式。

Rsbuild 默认提供了移除 console 的配置项，请查看 performance.removeConsole。

如何查看 Rsbuild 生成的 Rspack 配置?#

通过 Rsbuild 调试模式可以查看 Rsbuild 生成的 Rspack 配置。

你可以在执行构建时添加 DEBUG=rsbuild 环境变量，即可开启 Rsbuild 的调试模式，此时会输出内部生成的 Rspack 配置到 dist 目录下。

➜ DEBUG=rsbuild pnpm dev

  ...
  rsbuild init plugins
  rsbuild init plugins done
  rsbuild Use Rspack v1.0.0
  ...

Inspect config succeed, open following files to view the content:

  - Rsbuild Config: /root/my-project/dist/.rsbuild/rsbuild.config.mjs
  - Rspack Config (web): /root/my-project/dist/.rsbuild/rspack.config.web.mjs

如何忽略特定 warning 日志？#

默认情况下，Rsbuild 会打印构建过程产生的所有 error 和 warning 日志。

如果遇到由于三方包产生大量 warning 日志，暂时又无法处理，希望忽略的情况。可通过 Rspack 提供的 ignoreWarnings 配置忽略特定 warning 日志。

export default {
  tools: {
    rspack: {
      ignoreWarnings: [/Using \/ for division outside of calc()/],
    },
  },
};

详细信息可参考: ignoreWarnings。