Vue 插件#

Vue 插件提供了对 Vue 3 SFC（单文件组件）的支持，插件内部集成了 vue-loader v17 版本。

快速开始#

安装插件#

你可以通过如下的命令安装插件:

npm add @rsbuild/plugin-vue -D

注册插件#

你可以在 rsbuild.config.ts 文件中注册插件：

import { pluginVue } from '@rsbuild/plugin-vue';

export default {
  plugins: [pluginVue()],
};

注册完插件后，你可以直接在代码中引入 *.vue 单文件组件。

选项#

如果你需要自定义 Vue 的编译行为，可以使用以下配置项。

vueLoaderOptions#

传递给 vue-loader 的选项，请查阅 vue-loader 文档 来了解具体用法。

• 类型： VueLoaderOptions
• 默认值：

const defaultOptions = {
  compilerOptions: {
    preserveWhitespace: false,
  },
  experimentalInlineMatchResource: true,
};

• 示例：

pluginVue({
  vueLoaderOptions: {
    hotReload: false,
  },
});

splitChunks#

在 chunkSplit.strategy 设置为 split-by-experience 时，Rsbuild 默认会自动将 vue 和 router 相关的包拆分为单独的 chunk:

• lib-vue.js：包含 vue，vue-loader，以及 vue 的子依赖（@vue/shared，@vue/reactivity，@vue/runtime-dom，@vue/runtime-core）。
• lib-router.js：包含 vue-router。

该选项用于控制这一行为，决定是否需要将 vue 和 router 相关的包拆分为单独的 chunk。

• 类型：

type SplitVueChunkOptions = {
  vue?: boolean;
  router?: boolean;
};

• 默认值：

const defaultOptions = {
  vue: true,
  router: true,
};

• 示例：

pluginVue({
  splitChunks: {
    vue: false,
    router: false,
  },
});