close
  • 简体中文

      • 开发服务器

      rspack dev 和 rspack serve 命令会通过 @rspack/dev-server 启动本地开发服务器。它提供热模块替换（HMR）、静态文件服务、代理等开发能力。

      安装 dev server

      @rspack/dev-server 是 @rspack/cli 的可选 peer dependency。

      使用 rspack dev、rspack serve 或 rspack preview 前，请先安装：

      npm
      yarn
      pnpm
      bun
      deno
      npm add @rspack/dev-server -D

      HMR

      Rspack 在 dev 模式下默认开启了 HMR，你也可以在 Rspack 配置中设置 devServer.hot 选项来关闭 HMR。

      rspack.config.mjs
      export default {
  devServer: {
    hot: false,
  },
};
      Warning

      不要在 output.cssFilename 中包含 [hash] 或者 [contenthash]，否则 CSS 的 HMR 可能会不生效。

      Proxy

      开发服务器内置代理能力。你可以在 Rspack 配置中添加 devServer.proxy 选项来代理匹配的请求。该功能基于 http-proxy-middleware 实现。例如我们可以通过如下方式将 /api 代理到 http://localhost:3000。

      rspack.config.mjs
      export default {
  devServer: {
    proxy: [
      {
        context: ['/api'],
        target: 'http://localhost:3000',
        changeOrigin: true,
      },
    ],
  },
};

      更多关于 devServer 的配置项请参考 devServer。