close
  • 简体中文
  • dev.liveReload

    • 类型: boolean | { html?: boolean }
    • 默认值: true

    是否在源文件变更时自动刷新页面。

    默认情况下,Rsbuild 会优先使用 HMR 来更新模块。当 HMR 功能被禁用,或者某些场景 HMR 无法生效时,会自动降级到 liveReload。

    查看 模块热更新 来了解更多内容。

    禁用 live reload

    如果你需要禁用 live reload,可以将 dev.hmrdev.liveReload 同时设置为 false,此时页面不会发起 WebSocket 请求到 dev server,也不会在文件变更时自动刷新页面。

    rsbuild.config.ts
    export default {
      dev: {
        hmr: false,
        liveReload: false,
      },
    };

    选项

    liveReload.html

    • 类型: boolean
    • 默认值: true

    默认情况下,Rsbuild 会在 HTML 模板变更时触发整页刷新。

    liveReload 为对象时,你可以将 liveReload.html 设为 false 来避免在 HTML 模板变更时触发整页刷新:

    rsbuild.config.ts
    export default {
      dev: {
        liveReload: {
          html: false,
        },
      },
    };

    版本历史

    版本变更内容
    v2.0.0新增 html 选项