close
logologo
指南
配置
插件
API
社区
版本
更新日志
Rsbuild 0.x 文档
English
简体中文
指南
配置
插件
API
社区
更新日志
Rsbuild 0.x 文档
English
简体中文
logologo

开始

介绍
快速上手
功能导航
名词解释

框架

React
Vue
Preact
Svelte
Solid

基础

命令行工具
开发服务器
构建产物
静态资源
HTML
JSON
Wasm
TypeScript
Web Workers
部署静态站点
升级 Rsbuild

配置

配置 Rspack
配置 Rsbuild
配置 SWC

样式

CSS
CSS Modules
CSS-in-JS
Tailwind CSS v4
Tailwind CSS v3
UnoCSS

进阶

路径别名
环境变量
模块热更新
浏览器范围
浏览器兼容性
模块联邦
多环境构建
服务端渲染(SSR)
测试

优化

代码拆分
产物体积优化
提升构建性能
静态资源内联

迁移

从 Rsbuild 0.x 迁移
webpack
Create React App
Vue CLI
Vite
Vite 插件
Modern.js Builder

调试

开启调试模式
构建性能分析
使用 Rsdoctor

常见问题

通用类问题
功能类问题
异常类问题
热更新问题
📝 在 GitHub 上编辑此页
上一页通用类问题
下一页异常类问题

#功能类问题

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

如果需要配置组件库的按需引入,你可以通过 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 10:00:00 configuration loaded from: /path/to/...
  rsbuild 10:00:00 registering default plugins
  rsbuild 10:00:00 default plugins registered
  ...

config inspection completed, generated files:

  - 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。