跳到正文

快速开始 ​

先验证一个插件 ​

将以下内容放到已安装依赖的 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/ 下。更多常用场景。