unplugin

Unplugin 提供了一套单一的 Rollup 风格插件 API，可运行于 Vite、Rollup、webpack、esbuild、Rspack、Rolldown、Farm 和 Bun。在实现新的 unplugin、集成已有的 unplugin，或调试跨打包工具的 hook/context 行为时，可使用这些技能。

该技能基于 unplugin v3.0.0，生成于 2026-01-30。

核心参考

主题	描述	参考
概述	unplugin 是什么、支持的打包工具、何时使用	core-overview
核心 API	createUnplugin、工厂签名、各打包工具专用创建函数	core-api
Hook 与 context	生命周期 hook、过滤器、this.parse / emitFile / warn / error	core-hooks-and-context
Hook 兼容性	各打包工具对 hook 和 context 的支持表	core-hook-compatibility
集成	在 Vite、Rollup、webpack 等中安装和注册	core-integration

特性

主题	描述	参考
过滤器	用于 resolveId、transform、load 的 filter 选项（性能）	features-filters
嵌套插件	从工厂函数返回插件数组	features-nested-plugins
打包工具专用	meta.framework、逃生舱口（vite/webpack/esbuild/…）、createXxxPlugin	features-bundler-specific
虚拟模块	resolveId + load 模式；用于 load 的 filter	features-virtual-modules
解析	setParseImpl、this.parse；何时需要（esbuild、webpack 等）	features-parsing
输出与资源	emitFile（仅 EmittedAsset）、writeBundle（仅时机）	features-output-and-assets

最佳实践

主题	描述	参考
约定	unplugin- 前缀、关键字、默认 + 子路径导出	best-practices-conventions
诊断	this.warn / this.error、UnpluginMessage 结构	best-practices-diagnostics
脚手架	模板（unplugin-starter）、在线试用、前置条件	best-practices-scaffolding