功能导航

在这里，你可以了解到 Rsbuild 支持的主要功能。

JavaScript 编译

功能 描述 相关链接
Rspack 打包 默认使用 Rspack 作为打包工具 -
SWC 编译 默认通过 SWC 对 JavaScript 和 TypeScript 代码进行转译和压缩 -
TS 编译 默认通过 SWC 编译 TS 文件 * TypeScript 转译
代码压缩 默认在生产模式构建时开启代码压缩 * output.minify
Polyfill 注入 默认会注入 core-js 等 Polyfill 浏览器兼容性 output.polyfill
SourceMap 生成 默认在开发模式生成 SourceMap * output.sourceMap
文件别名 可选功能，通过 alias 设置文件别名 路径别名 source.alias
Babel 编译 可选功能，通过 Babel 对 JavaScript 和 TypeScript 代码进行转译 * Babel 插件
Node 产物 可选功能，支持构建出运行在 Node.js 环境的 JavaScript 产物 * Node 产物
Web Worker 产物 可选功能，支持构建出运行在 Web Worker 环境的 JavaScript 产物 * Web Worker 产物
浏览器范围 可选功能，通过 browserslist 来设置 Web 应用需要兼容的浏览器范围 * 浏览器范围
兼容性检查 可选功能，分析构建产物中是否存在当前浏览器范围下不兼容的高级语法 * @rsbuild/plugin-check-syntax
注入环境变量 可选功能，向代码中注入环境变量或表达式 * 环境变量
Node polyfill 可选功能，在浏览器端注入 Node 核心模块的 polyfills * Node Polyfill 插件
TS 类型检查 可选功能，运行 type checker 检查代码中的类型问题 * 类型检查
模块联邦 可选功能，动态加载模块，并共享依赖关系 * 模块联邦

CSS 编译

功能 描述 相关链接
Lightning CSS 默认启用，使用 Lightning CSS 降级 CSS 语法 * 引用样式资源
PostCSS 转换 可选功能，开启 PostCSS 转换 引用样式资源 tools.postcss
Sass 预处理器 可选功能，编译 Sass/Scss 文件 引用样式资源 Sass 插件
Less 预处理器 可选功能，编译 Less 文件 引用样式资源 Less 插件
Stylus 预处理器 可选功能，编译 Stylus 文件 引用样式资源 Stylus 插件
CSS Modules 编译 默认支持编译 CSS Modules 文件 使用 CSS Modules tools.cssLoader
CSS Modules 类型提示 可选功能，生成 CSS Modules 的类型定义文件 * Typed CSS Modules 插件
CSS 压缩 默认在生产模式构建时开启 CSS 压缩 * 引用样式资源
内联 CSS 到 JS 中 可选功能，将 CSS 文件内联到 JS 文件中 引用样式资源 output.injectStyles

HTML 编译

功能 描述 相关链接
设置标题 设置 HTML 的 title 标签 设置页面标题 html.title
设置 meta 设置 HTML 的 meta 标签 设置 meta 标签 html.meta
设置 favicon 设置页面的 favicon 图标 设置页面图标 html.favicon
设置 app 图标 设置 iOS 系统下的 apple icon 设置页面图标 html.appIcon
使用 EJS 模板引擎 可选功能，使用 EJS 模板语法 * 模板引擎 - EJS
使用 Pug 模板引擎 可选功能，使用 Pug 模板语法 * Pug 插件
内联 JS 文件 可选功能，将 JS 内联到 HTML 中 静态资源内联 output.inlineScripts
内联 CSS 文件 可选功能，将 CSS 内联到 HTML 中 静态资源内联 output.inlineStyles

开发预览相关

功能 描述 相关链接
Public 目录 默认将 public 目录作为静态资源服务的文件夹 * server.publicDir
请求代理 可选功能，将请求代理到指定的服务上 * server.proxy
打开页面 可选功能，在启动 server 时自动在浏览器中打开页面 * server.open
HTTPS 可选功能，开启 server 对 HTTPS 的支持 * server.https

框架支持

功能 描述 相关链接
React 可选功能，开启 React JSX 语法编译 * React 插件
React Refresh 可选功能，开启 React Refresh 热更新 模块热更新 dev.hmr
SVGR 可选功能，转换 SVG 为 React 组件 * SVGR 插件
Vue 3 SFC 可选功能，开启 Vue 3 SFC 单文件组件编译 * Vue 插件
Vue 3 JSX 可选功能，开启 Vue 3 JSX 语法编译 * Vue JSX 插件
Vue 2 SFC 可选功能，开启 Vue 2 SFC 单文件组件编译 * Vue 2 插件
Vue 2 JSX 可选功能，开启 Vue 2 JSX 语法编译 * Vue 2 JSX 插件
Svelte 可选功能，开启 Svelte 组件编译 * Svelte 插件
Solid 可选功能，开启 Solid JSX 语法编译 * Solid 插件

静态资源相关

功能 描述 相关链接
引用图片资源 支持在代码中引用图片资源 * 引用静态资源
引用字体资源 支持在代码中引用字体资源 * 引用静态资源
引用视频资源 支持在代码中引用视频资源 * 引用静态资源
引用 Wasm 资源 支持在代码中引用 WebAssembly 资源 * 引用 Wasm 资源
引用 node addons 支持在代码中引用 Node.js addons -
静态资源内联 默认将体积较小的图片等资源内联到 JS 中 静态资源内联 output.dataUriLimit
清理静态资源 每次开始构建前，自动清理 dist 目录下的静态资源 * output.cleanDistPath
拷贝静态资源 可选功能，将静态资源拷贝到 dist 目录下 * output.copy

性能相关

功能 描述 相关链接
产物自动拆包 Rsbuild 中内置了多种拆包策略，自动将代码包拆分为体积适中的文件 拆包最佳实践 performance.chunkSplit
展示产物体积 在生产模式构建后，默认展示所有静态资源的体积信息 * performance.printFileSize
分析产物体积 可选功能，通过 Bundle Analyzer 分析产物体积 * performance.bundleAnalyze
移除 console 可选功能，移除代码中的 console.[methodName] * performance.removeConsole
优化 moment.js 体积 可选功能，移除 moment.js 多余的 locale 文件 * performance.removeMomentLocale
组件库按需引入 可选功能，按需引入组件库的代码和样式 * source.transformImport
图片压缩 可选功能，对引用的图片资源进行压缩处理 * Image Compress 插件
Preload 可选功能，对资源进行预加载 * performance.preload
Prefetch 可选功能，对资源进行预获取 * performance.prefetch
Preconnect 可选功能，对资源进行预连接 * performance.preconnect
DNS prefetch 可选功能，对资源进行 DNS 预获取 * performance.dnsPrefetch