写在前面

v1 的主题是：API 稳定性承诺与生产就绪标志。话说回来，

经过 5 个版本的迭代。插件程序从最初的 2 个插件发展到 15 个插件覆盖建立全生命周期；common 工具模块从零散函数发展为 8 个规范化子模块；插件开发框架趋于成熟，v1 标记 API 稳定性，后续变更将严格遵循语义化版本规范。

这不是一个包含大量新功能的版本。而是一个里程碑——宣告插件程序已具备生产可用性，并承诺 API 稳定性。

本版主要：

能力	一句话说明	你需要做什么
API 稳定性承诺后续破坏性变更需升主版本号。遵循 semver放心在生产环境使用15个插件完整就绪覆盖生成、压缩、复制、分析、注入、守卫、代理大类按需选用7个分组子方法导出按功能分组导出，利于 Tree-shaking可从分组子方法导入14个 Common 子模块通用工具规范化抽离，可独立复用按需从 common 子方法导入插件开发框架成熟BasePlugin + Logger + Validator + createPluginFactory可基于框架开发自定义插件零配置可用所有插件参数可选化，提供合理默认值无需配置即可上手。
升级方式：修改 "devDependencies" 中版本号为 "^1.0.0". No Breaking Change,可从 0.x 平滑升级。

一、分钟快速上手

安装与升级

{
"devDependencies": {
"@meng-xi/vite-plugin": "^1.0.0"
}
}

从 0.x 平滑升级

. No Breaking Change，直接升级即可：

所有旧用法在 v1 中保持不变：

// vite.config.ts
import { defineConfig } from 'vite'
import { compressAssets,generateRouter,generateVersion } from '@meng-xi/vite-plugin'
export default defineConfig({
plugins:
})

推荐用法这方面，按分组导入

. 推荐使用分组子方法导入，利于 Tree-shaking：

// 按分组导入
import { compressAssets } from '@meng-xi/vite-plugin/plugins/compress'
import { generateRouter,generateVersion } from '@meng-xi/vite-plugin/plugins/generate'
import { loadingManager } from '@meng-xi/vite-plugin/plugins/inject'
import { envGuard } from '@meng-xi/vite-plugin/plugins/guard'
import { proxyManager } from '@meng-xi/vite-plugin/plugins/proxy'
import { bundleAnalyzer,buildProgress } from '@meng-xi/vite-plugin/plugins/analyze'
import { assetManifest,copyFile } from '@meng-xi/vite-plugin/plugins/copy'
// 主入口导入
import { compressAssets,generateRouter } from '@meng-xi/vite-plugin'

二、从 5.x 到 6.x 的演进历程

三个阶段回顾

阶段	版本范围	主题	插件数量
Mingling Phase	<=5.x-5.x5	Bases Plugins	15 插件总量

关键里程碑事件
6 发布 API 稳定性承诺 与生产就绪标志
数量增长曲线 -   -   -   -   -   -   → The versions scale linearly as more plugins are added.

三、插件程序完整清单

#15 插件。按功能划分为 #7 分组 : analyze / compress / copy / generate / guard / inject / proxy.

analyze 分组 —— 建立分析

ID:/enforce />

buildProgress/终端建立进度条支持 bar/spinner/minimal 三种格式

bundleAnalyzer post产物体积分析生成 JSON/HTML 报告 支持阈值告警与历史对比

compress 分组 —— 压缩产物

compressAssets post gzip/brotli 压缩生成 .gz/.br 文件 支持并发与统计报告

imageOptimizer post 图片压缩与格式转换 支持 WebP/IF 转换

copy 分组 —— 文件复制与清单

assetManifest post资源清单生成支持 vite/webpack/custom 三种格式 与运行时注入

copyFile post文件/目录复制支持增量复制 并发控制 与错误策略

generate 分组 —— 配置与代码生成

autoImport pre自动导入 支持通配符 * 方法扫描 Vue模板 与类型声明生成

generateRouter - 根据 pages.json 生路由配置 与类型声明

generateVersion -版本号生成 支持多种文件占位符 与全局变量注入

guard 分组 —— 环境守卫

envGuard post环境变量校验 支持多种类型运行时守卫 与.env 模板生成

inject 分组 —— HTML 与运行时注入

faviconManager 网站图标管理 支持字符串简写 配置 自定义 link 标签

htmlInject HTML 内容注入 种位置 条件注入 模板变量 安全过滤

loadingManager 全局 Loading 状态管理 请求自动拦截 防抖 动画过渡

versionUpdateChecker runtime 更新检查 三种提示 UI 自定义模板

proxy 分组 —— 开发代理

proxyManager 开发代理管理 方法匹配 请求重写 延迟模拟 环境变量覆盖

Common 工具模块程序:

• 提供 JS_KEYWORDS 静态分析时移除注释字符串等工具。
• calculateGzipSize 用于估算压缩大小。
• runWithConcurrency 并发限制批量异步执行。
• parseEnvContent 用来解析.env 文件内容。
• parseTemplate 等模板解析工具。
• writeFileSyncSafely 等文件读写工具。
• generateRandomHash 用来生成缓存破坏哈希。
• -injectBeforeTag injectHeadAndBody 等 HTML 注入工具。`BasePlugin` 开发框架：** 为自定义插件提供完整生命周期管理和统一错误处理。
  • AddHook 自动包裹 enabled 检查 和 errorStrategy 错误处理。
  • CreatePluginFactory 工厂函数支持字符串简写配置。

    常见使用者痛点 &amp，amp;amp，amp;amp，amp;migrate:

    • 兼容性恐慌 – “我担心 Vite 或 Node 的更新会导致我的项目崩溃。”
    • 配置臃肿 – “我想要一个“开箱即用”的体验，却必须填写一大堆必填字段。”
    • Tree‑Shaking 效率低 – “即使只用了一个小功能，我也看到整个依赖被打包进了最终产物。”
    • 升级成本高 – “每一次 major 升级都要改很多地方。 ”

    本次发布针对以上痛点进行了调整：

    • 所有必填字段均已设为可选或提供安全默认值；
    • 提供按功能分组子方法导出，让无关代码完全被剔除；
    • 所有 breaking change 均锁定至 major，只在必要时才会引起迁移；
    • 对外部依赖做了降级策略，例如缺失 sharp 时仅保留 SVG 调整。

    ---

    从示例来看，简单项目配置

    // vite.config.ts
    import { defineConfig } from 'vite';import uni from '@dcloudio/vite-plugin-uni';import {
    generateRouter,generateVersion,autoImport,compressAssets,imageOptimizer,assetManifest,bundleAnalyzer。envGuard,htmlInject,loadingManager,faviconManager,versionUpdateChecker,} from '@meng-xi/vite-plugin';

    export default defineConfig({ plugins:[ uni,generateRouter,generateVersion,autoImport,envGuard({ required:{ VITEAPIURL:{type:'url',required:true},VITEAPPTITLE:{type:'string'。required:true} } }),htmlInject({ 从rules来看，[{id:'description',content:'`

    示例的观点是，基于 BasePlugin 开发自定义版权插桩器

    
    
    interface CopyrightOptions{
    从author来看，string;year，:number;怎么说呢，}
    
    class CopyrightInjector extends BasePlugin<CopyrightOptions>{
    protected getPluginName{return 'copyright-'}
    protected getDefaultOptions{return{author:"Unknown"。year:new Date.getFullYear}}
    protected validateOptions{
    this.validator.field.required;}
    protected addHooks{
    this.registerTransformIndexHtml=>{
    const copyright=;return html.replace;},'注入版权')，}
    }
    
    export const copyrightInjector=createPluginFactory;<\/script>`
    
    至于示例，复用 Common 工具模块
    
    import{deepMerge}from'@meng‑xi/plugin/common/object';import{generateRandomHash}from'@m…/hash'，import{parseTemplate}from'@m…/format'，
    
    
    const merged = deepMerge;const hash = generateRandomHash;const header = parseTemplate;按理说，<\/script>`
    
    
    &amp，migrate:
    
    本次发布证明 Vite 插件环境已经可以满足真正的生产需求：
    
    
    15 个覆盖全生命周期 的主要功能；其实，
    
    8 个 Common 子模块 降低开发成本；
    
    四层级导出结构 为 Tree-shaking 提供最大灵活度；
    
    统一日志程序 &amp，migrate 错误策略 确保建立稳定。
    
    
    如果您正在考虑将此套件迁移到现有项目或开始新项目。请参考以下步骤：
    
    bash
    
    pnpm update @meng‑xi/vit‑plugin@^1
    
    vite dev
    
    vite build && ls dist/.json dist/.gz dist/.br dist/.manifest.json
    
    
    若出现任何问题，请在 GitHub Issues 提交反馈，我们将及时修复。
    

---