进阶 sli.dev 2026-11-21 18:58:32 · 7 阅读

第21章 配置 Vite 与插件

配置 Vite 和插件 ​

环境:node

此配置函数只在 Node.js 环境下运行,因此可以访问 Node 的 API。

Slidev 底层由 Vite 驱动,这意味着你可以借助 Vite 强大的插件系统进一步自定义幻灯片。如果你已有 vite.config.ts,Slidev 会将它与自身、主题及 addons 提供的 Vite 配置合并。

配置内部插件 ​

Slidev 内部向 Vite 添加了以下插件:

- @vitejs/plugin-vue - unplugin-vue-components - unplugin-icons - vite-plugin-vue-markdown - vite-plugin-remote-assets - unocss/vite

要配置上述内置插件,请创建一个内容如下的 vite.config.ts。注意 Slidev 对这些插件有默认配置,这种用法会覆盖其中部分配置,可能导致应用出问题。请将此视为高级功能,在继续之前确保你清楚自己在做什么。

vite.config.ts

```ts import { defineConfig } from 'vite'

export default defineConfig({ slidev: { vue: { /* vue options */ }, markdown: { /* markdown-exit options */ markdownSetup(md) { /* custom markdown-exit plugins */ md.use(MyPlugin) }, }, /* options for other plugins */ }, }) ```

更多选项请参阅类型声明。

WARNING

不允许重复添加 Slidev 内部已使用的插件。例如,不要这样写:

```ts import Vue from '@vitejs/plugin-vue' import { defineConfig } from 'vite'

export default defineConfig({ plugins: [ Vue({ /* vue options */ }) ], }) ```

而应按照上文所述,把 Vue 的选项传给 slidev.vue 字段。

根据幻灯片数据添加自定义插件 ​

通常你可以直接在 vite.config.ts 中添加 Vite 插件(见上文)。但如果需要根据幻灯片数据来添加插件,则需创建一个内容如下的 ./setup/vite-plugins.ts:

```ts import { defineVitePluginsSetup } from '@slidev/types'

export default defineVitePluginsSetup((options) => { return [ // Your plugins here // Slide data is available as options.data.slides ] }) ```

评论 (0)