快速开始
先验证一个插件
将以下内容放到已安装依赖的 Vite 应用的 vite.config.ts。已有配置时,在原 plugins 数组中追加 buildInfo(...)。
ts
import { defineConfig } from "vite";
import { buildInfo } from "fast-vite-plugins";
export default defineConfig({
plugins: [buildInfo({ fileName: "meta/build-info.json" })],
});运行 pnpm exec vite build,在默认输出目录查看 dist/meta/build-info.json。应看到 version、builtAt 和 mode 字段。项目自定义 build.outDir 时,在对应目录下找 meta/build-info.json。
组合多个插件
SDK 内置错误与警告诊断使用英文,并保留 [fast-vite:插件名] 前缀及相关配置、路径信息。调用方自定义校验消息和底层原始异常保持原样;提示语言调整不改变错误类型、触发条件及 error / warn 策略。
ts
import { defineConfig } from "vite";
import { buildInfo, bundleBudget, compression, envGuard, subresourceIntegrity } from "fast-vite-plugins";
export default defineConfig({
plugins: [
envGuard({
schema: {
VITE_API_URL: { pattern: /^https:\/\// },
},
}),
buildInfo(),
subresourceIntegrity({ manifest: true }),
bundleBudget({
budgets: [
{ name: "入口 JS", filter: /\.js$/, limit: 250 * 1024 },
{ name: "全部 CSS(gzip)", filter: /\.css$/, limit: 50 * 1024, mode: "gzip", scope: "total" },
],
}),
compression({
algorithms: ["gzip", "brotli"],
threshold: 10 * 1024,
}),
],
});每个插件都需要独立导入和配置,库不会隐式启用任何能力:
ts
import { defineConfig } from "vite";
import { buildInfo, htmlTemplate } from "fast-vite-plugins";
export default defineConfig({
plugins: [htmlTemplate({ data: { APP_TITLE: "Fast Admin" }, strict: true }), buildInfo({ fileName: "meta/build-info.json" })],
});构建完成但找不到构建信息文件
先核对 buildInfo 是否加在本次构建使用的配置里,再按 fileName 到实际输出目录查找。若配置了 fileName: "meta/build-info.json",文件就在输出目录的 meta/ 下。更多常用场景。
