了解 Vite 插件

众所周知 Vite 是基于 Rollup 的构建工具，Vite 插件为了优化、扩展项目构建系统功能的工具。

比如 vite-plugin-eslint 为我们提供了代码分析的功能，帮助我们在开发过程中的风格一致性。

简单示例

本文中的示例是基于 Vite + Vue3.x + TypeScript 来实现。

插件命名应该遵守社区的规则，如果你的插件不使用 Vite 特有的钩子，应该使用 rollup-plugin- 作为前缀；反之应该使用 vite-plugin- 作文前缀，如果插件只适用于特定的框架，应该使用 vite-plugin-vue- 作为前缀。

// plugins/vite-plugin-xxx/index.ts
import type { Plugin } from 'vite'export default (): Plugin => {return {name: 'vite-plugin-xxx',apply: 'serve',}
}

apply 默认在开发 serve 和构建 build 模式下都会调用。

钩子函数

Vite 插件的钩子函数可以帮助我们在构建流程中插入自定义的事件逻辑；

由于 Vite 是基于 Rollup 实现的，所有 Vite 在遵循 Rollup 构建时的钩子同时为我们提供了 Vite 独有的钩子。

config

config 钩子在运行前执行，用于解析与修改 Vite 的默认配置。

import type { Plugin } from 'vite'export default (): Plugin => {return {name: 'vite-plugin-xxx',apply: 'serve',config(config, { command }) {if (command === 'serve') {config.server.port = 3000}},}
}

以上的示例中，我们对原有配置的默认端口号5173修改为3000，当然这样的修改毫无意义，因为我们可以在 vite.config.ts 中直接去修改端口号，而本篇文章的目的是为了理解 config 钩子的作用。

configResolved

configResolved 钩子在解析 Vite 配置之后调用，用于获取最终的配置。

在以下的示例中对参数的进行校验以及插件初始化任务的执行。

import type { Plugin } from 'vite'export default (): Plugin => {return {name: 'vite-plugin-xxx',apply: 'serve',config(config) {console.log('config', config)},configResolved(resolvedConfig) {console.log('configResolved', resolvedConfig)// 判断参数是否正确if (!resolvedConfig.base) {console.error('配置错误')return}// 初始化任务// initCoustomPlugin(resolvedConfig)},}
}

configureServer

configureServer 钩子用于配置开发服务器的钩子，我们通常在这里添加自定义的中间件。

在以下的示例中自定义了一个 /_dev 的接口，由此可见通过 configureServer 钩子可以在开发阶段与项目进行结合，可以扩展前端操作 os 等能力。

import type { Plugin } from 'vite'export default (): Plugin => {return {name: 'vite-plugin-xxx',apply: 'serve',configureServer(server) {server.middlewares.use('/_dev', async (req, res) => {res.writeHead(200, { 'Content-Type': 'application/json' })res.end('Hello VitePlugin')})},}
}

configurePreviewServer

configurePreviewServer 钩子与 configureServer 钩子一样，但 configurePreviewServer 用于预览服务器，通过 vite preview 命令启动。

import type { Plugin } from 'vite'export default (): Plugin => {return {name: 'vite-plugin-xxx',apply: 'serve',configurePreviewServer(server) {server.middlewares.use('/_dev', async (req, res) => {res.writeHead(200, { 'Content-Type': 'application/json' })res.end('Hello PreviewServer')})},}
}

transformIndexHtml

transformIndexHtml 钩子可以动态的修改或者注入 HTML 的内容，以及实现自定义的处理逻辑。

比如一下的示例中，我们在 #app 的节点下插入了 loading... 的文案，由此我们可以扩展更多的玩法，比如注入一些 loading 加载的动画。

import type { Plugin } from 'vite'export default (): Plugin => {return {name: 'vite-plugin-xxx',apply: 'serve',transformIndexHtml(html) {return html.replace('<div id="app">', `<div id="app">loading...`)},}
}

handleHotUpdate

handleHotUpdate 钩子用于自定义执行 HMR 热更新的处理。

import type { Plugin } from 'vite'export default (): Plugin => {return {name: 'vite-plugin-xxx',apply: 'serve',handleHotUpdate(ctx) {// 热更新的文件信息console.log(ctx)// 热更新自定义事件ctx.server.ws.send({type: 'custom',event: 'custom',data: 'custom',})},}
}

页面上调用监听，并自定义处理更新的逻辑。

if (import.meta.hot) {import.meta.hot.on('custom', data => {// 执行自定义更新console.log(data)})
}

总结

Vite 插件系统为开发者提供了丰富的扩展，极大提高了开发的效率以及项目构建时的扩展性。

在日常开发过程中，使用 Vite 的插件，编写自己的插件，通过 Vite 插件的系统简化工作的流程是非常棒的一件事情。

最后

感谢你的阅读~

如果你有任何的疑问欢迎您在后台私信，我们一同探讨学习！

如果觉得这篇文章对你有所帮助，点赞、在看是最大的支持！