在 vite 项目中,插件通过 `vite.config.js` 的 `plugins` 数组注入,vite 基于 rollup 插件接口运行,支持开发服务器中间件和构建后处理。开发者只需安装插件包并在配置中引入即可生效,无需手动挂载到 express 实例。插件分为开发时(dev)和构建时(build)两种生命周期,分别对应不同的钩子函数。

如何配置并启用一个基础 Vite 插件
要启用插件,需将其导入并放入 `vite.config.js` 的 `plugins` 数组中。以官方推荐的 `@vitejs/plugin-react` 为例,它会自动处理 JSX 转换。配置完成后,启动 `npm run dev` 即可看到效果。插件对象必须包含 `name` 属性,且可选 `configResolved` 等钩子来读取最终配置。

import { defineConfig } from 'vite';
import react from '@vitejs/plugin-react';
export default defineConfig({
plugins: [react()],
});
上述代码展示了最简配置。`defineConfig` 确保类型提示正确。`react()` 返回一个符合 Rollup 插件接口的对象。当 Vite 启动时,它会遍历该数组并注册每个插件。若插件需要选项,如 `babel: {}`,则直接传入第二个参数。此配置仅涉及开发服务器,未触及构建阶段的具体输出。
立即学习“Java免费学习笔记(深入)”;
如何编写自定义插件拦截请求
自定义插件通常用于处理特定文件类型或修改响应。核心方法是实现 `transformIndexHtml` 或 `configureServer` 钩子。例如,拦截 `/api` 请求并返回模拟数据,可使用 `server.middlewares`。对于静态资源,使用 `load` 钩子直接返回内容字符串,跳过文件系统读取。这能显著提升冷启动速度。

import { defineConfig } from 'vite';
export default defineConfig({
plugins: [{
name: 'mock-api',
configureServer(server) {
server.middlewares.use('/api', (req, res) => {
res.setHeader('Content-Type', 'application/json');
res.end(JSON.stringify({ status: 'ok' }));
});
}
}]
});
该插件在开发服务器启动时执行。`configureServer` 接收 `server` 实例,通过 `middlewares.use` 挂载 Koa 风格的中间件。路径 `/api` 被精确匹配。当浏览器请求该 URL 时,中间件直接响应 JSON,不经过后端服务。此方法适用于前端独立开发时的 Mock 数据场景。注意,此逻辑仅在 `dev` 模式下有效,构建时不会执行。
插件在构建阶段如何处理 CSS 提取
在构建阶段,Vite 默认将 CSS 内联到 JS 中或通过 `` 标签加载。若需提取为独立 `.css` 文件,需配置 `build.cssCodeSplit` 或使用相关插件。`@vitejs/plugin-vue` 等框架插件会自动处理 scoped CSS 的提取。对于普通 CSS,Vite 会优化压缩。若插件需干预此过程,可监听 `generateBundle` 钩子,检查输出的 chunk 并移动资产文件。此过程发生在 `rollup` 打包之后,确保所有依赖已解析。


















