# 📦 Vite 构建压缩插件：vite-plugin-pack-orchestrator

## 🤔 为什么又造一个轮子？

市面上已经有一些 Vite 打包插件，比如 `vite-plugin-zip-pack`、`vite-plugin-compress` 等，能用，但总差那么点意思 — 大多只支持 ZIP，功能也比较单一。

实际项目里，打包这个环节往往没那么简单：

1.  **多种压缩格式** 🗜️ — ZIP 方便分享给同事，TAR.GZ 部署到 Linux 服务器，7Z 追求更高压缩比存档归档，不同场景需要不同格式
2.  **文件校验** 🔐 — 打包后需要 MD5/SHA1 校验值来确认版本一致性，尤其是发布给客户的场景
3.  **灵活命名** ✏️ — 版本号、时间戳、哈希值，文件名里能带的信息越多越好
4.  **CI/CD 友好** 🚀 — 流水线里每次构建产物都应该是唯一可追溯的，压缩后自动带哈希改名，省去人工处理的麻烦（写脚本去改也麻烦一些）

现有插件基本没法同时满足这些，所以写了 `vite-plugin-pack-orchestrator`。

## ⚡ 和其他插件有什么不同

| 功能      | 大多数打包插件   | 本插件                                                |
| :------ | :-------- | :------------------------------------------------- |
| 压缩格式    | 仅 ZIP     | ZIP / TAR / TAR.GZ / 7Z （RAR需要商业授权，所以没搞）           |
| 校验和     | 无         | MD5 / SHA1 / SHA256                                |
| 文件名模板   | 固定命名      | 支持 `[name]` `[version]` `[timestamp]` `[hash]` 占位符 |
| Hook 扩展 | 无         | `onBeforeBuild` / `onAfterBuild` / `onError` 等钩子   |
| 文件过滤    | 部分支持      | `include` + `exclude` glob 模式                      |
| 7Z 支持   | 需要系统安装 7z | 内置，零依赖                                             |
| 输出目录控制  | 固定位置      | `archiveOutDir` 自定义                                |

## 📥 安装

```bash
npm install vite-plugin-pack-orchestrator -D
```

## 🚀 快速上手

最基本的用法，两行配置搞定：

```typescript
// vite.config.ts
import { defineConfig } from 'vite';
import orchestrator from 'vite-plugin-pack-orchestrator';

export default defineConfig({
  plugins: [
    orchestrator({
      pack: {
        outDir: 'dist',          // 要打包的目录，默认就是 'dist'
        format: 'zip',           // 压缩格式：zip | tar | tar.gz | 7z
        fileName: 'myapp',       // 压缩包文件名
      },
    }),
  ],
  build: { outDir: 'dist' },
});
```

执行 `vite build` 后，会在项目根目录生成 `myapp.zip`。

## ⚙️ 配置项详解

### pack — 打包配置

```typescript
pack: {
  outDir: 'dist',              // 要打包的源目录（相对于项目根目录），默认 'dist'
  fileName: 'myapp',           // 文件名，支持占位符（见下方说明）
  format: 'zip',               // 压缩格式：'zip' | 'tar' | 'tar.gz' | '7z'
  compressionLevel: 9,         // 压缩级别 0-9，默认 9（最高压缩率）
  archiveOutDir: './releases', // 压缩包输出目录，不写默认项目根目录
  exclude: ['**/*.map'],       // 排除的文件（glob 匹配）
  include: ['**/*.js'],        // 只包含的文件（可选，不设置则包含全部）
}
```

### fileName 占位符

文件名支持以下占位符，打包时自动替换：

| 占位符           | 说明                      | 示例值               |
| :------------ | :---------------------- | :---------------- |
| `[name]`      | package.json 中的 name    | `my-awesome-app`  |
| `[version]`   | package.json 中的 version | `1.2.0`           |
| `[timestamp]` | 当前时间戳                   | `1714012345678`   |
| `[hash]`      | 构建内容 MD5 哈希（完整 32 位）    | `a1b2c3d4e5f6...` |
| `[hash:8]`    | MD5 哈希前 N 位（自定义长度）      | `a1b2c3d4`        |

```typescript
// 示例：fileName 设为 'release-[version]-[timestamp]'
// 输出：release-1.2.0-1714012345678.zip

// 示例：fileName 设为 '[name]-v[version]'
// 输出：my-awesome-app-v1.2.0.zip

// 示例：fileName 设为 '[name]-[hash]'
// 输出：my-awesome-app-a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6.zip

// 示例：fileName 设为 '[name]-[hash:8]'
// 输出：my-awesome-app-a1b2c3d4.zip
```

如果 fileName 不包含扩展名，插件会根据 format 自动追加 `.zip`、`.tar.gz` 等后缀。

### 🔗 hooks — 钩子函数

#### onBeforeBuild — 构建前执行

在 Vite 开始打包之前执行，适合做一些前置清理工作：

```typescript
hooks: {
  onBeforeBuild: async () => {
    // 构建前的一些处理
  },
}
```

#### onBundleGenerated — bundle 生成后执行

Vite bundle 生成后、压缩包创建前执行，可以拿到构建产物信息：

```typescript
hooks: {
  onBundleGenerated: (bundle) => {
    console.log('生成的文件:', Object.keys(bundle));
  },
}
```

#### onAfterBuild — 压缩完成后执行（核心）

**这是本插件最强大的功能。** 压缩包创建完成后，插件会自动计算 MD5 / SHA1 / SHA256 三种校验和，然后传给 `onAfterBuild`。你可以利用这些校验和来**重命名压缩包**。

返回一个新路径（和原路径不同），插件会自动重命名文件：

```typescript
hooks: {
  onAfterBuild: (path, format, checksums) => {
    // path      — 当前压缩包的完整路径
    // format    — 压缩格式（'zip' | 'tar' | 'tar.gz' | '7z'）
    // checksums — 校验和对象：{ md5: string, sha1: string, sha256: string }
    return path; // 返回原路径则不重命名
  },
}
```

**实际案例：**

```typescript
// 案例 1：在扩展名前插入 SHA1 短哈希（最常用）
// myapp.zip → myapp-3a7b2c1d.zip
onAfterBuild: (path, format, checksums) =>
  path.replace(/(\.(?:zip|tar\.gz|tar|7z))$/, `-${checksums.sha1.slice(0, 8)}$1`);

// 案例 2：用 MD5 全量替换文件名
// myapp.zip → a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6.zip
onAfterBuild: (path, format, checksums) =>
  path.replace(/^.+(?=\.\w+$)/, checksums.md5);

// 案例 3：追加格式和哈希到原始文件名
// myapp.zip → myapp-zip-a1b2c3d4.zip
onAfterBuild: (path, format, checksums) =>
  path.replace(/(\.\w+)$/, `-${format}-${checksums.sha256.slice(0, 8)}$1`);

// 案例 4：完全自定义文件名，用 format 参数自动适配后缀
// myapp.zip → release-a1b2c3d4e5f6.zip
onAfterBuild: (path, format, checksums) =>
  `release-${checksums.md5.slice(0, 12)}.${format}`;

// 案例 5：不重命名，只是拿校验和做点其他事（比如写入文件）
onAfterBuild: async (path, format, checksums) => {
  fs.writeFileSync('checksums.json', JSON.stringify(checksums));
  // 不 return 或 return 原路径 = 不重命名
}
```

#### onError — 出错时执行

打包失败时回调，适合接入告警通知：

```typescript
hooks: {
  onError: async (error) => {
    console.error('打包出错了：', error.message);
    // 可以在这里接入钉钉/企业微信告警
  },
}
```

## 🔄 为什么说压缩后自动改名对 CI/CD 很重要？

在持续集成/持续部署的流水线中，每次构建的产物都需要是**唯一可追溯**的。如果压缩包文件名固定叫 `dist.zip`，你怎么知道这次构建和上次有什么区别？回滚的时候该拿哪个版本？

本插件通过 `onAfterBuild` 钩子拿到校验和后，可以自动在文件名中插入哈希值：

```typescript
hooks: {
  onAfterBuild: (path, format, checksums) =>
    path.replace(/(\.zip)$/, `-${checksums.sha1.slice(0, 8)}$1`);
}
```

构建后输出：

    myapp-1.0.2-3a7b2c1d.zip
    myapp-1.0.2-7f9e4b2a.zip

**文件名本身就是指纹** 🔑，一眼就能区分不同构建，部署脚本直接按文件名定位版本，不需要额外维护版本映射表。回滚也简单 — 找到上一个哈希文件名部署即可。配合 `[version]` `[timestamp]` 占位符，追溯性更强。

## 🎯 完整示例

把前面的配置合在一起，就是一个完整的生产级配置：

```typescript
// vite.config.ts
import { defineConfig } from 'vite';
import orchestrator from 'vite-plugin-pack-orchestrator';

export default defineConfig({
  plugins: [
    orchestrator({
      pack: {
        outDir: 'dist',                    // 打包 dist 目录
        fileName: 'myapp-[version]',       // 文件名带版本号
        format: 'zip',                     // ZIP 格式
        archiveOutDir: './releases',       // 输出到 releases 目录
        exclude: ['**/*.map'],             // 排除 sourcemap
      },
      hooks: {
        // 压缩完成后自动加上 SHA1 哈希
        onAfterBuild: (path, format, checksums) =>
          path.replace(/(\.(?:zip|tar\.gz|tar|7z))$/, `-${checksums.sha1.slice(0, 8)}$1`),
        // 出错时打印日志
        onError: (error) => console.error('打包失败：', error.message),
      },
    }),
  ],
  build: { outDir: 'dist' },
});
```

`vite build` 一次搞定，不需要额外的打包脚本。

***

插件很轻量，代码开源，欢迎试用和提建议 🎉

*   npm: [vite-plugin-pack-orchestrator](https://www.npmjs.com/package/vite-plugin-pack-orchestrator)
*   Gitee: [vite-plugin-pack-orchestrator](https://gitee.com/wangkai000/vite-plugin-pack-orchestrator)
*   GitHub: [wangkai000/vite-plugin-pack-orchestrator](https://github.com/wangkai000/vite-plugin-pack-orchestrator)




市面上已经有一些 Vite 打包插件，比如 vite-plugin-zip-pack、vite-plugin-compress 等，能用，但总差那么点意思 — 大多只支持 ZIP，功能也比较单一。

别再写改名脚本了，一个 Vite 插件搞定压缩、校验、自动哈希命名vite-plugin-pack-orchestrator

别再写改名脚本了，一个 Vite 插件搞定压缩、校验、自动哈希命名vite-plugin-pack-orchestrator市面上已经有一些 Vite 打包插件，比如 vite-plugin-zip-pack、vite-plugin-compress 等，能用，但总差那么点意思 — 大多只支持 ZIP，功能也比较单一。

前端

架构设计

开发工具

Vite打包插件vite-plugin-pack-orchestrator支持ZIP/TAR/TAR.GZ/7Z多种格式，提供文件校验、自定义命名和CI/CD集成功能。通过钩子函数实现构建前后处理，自动生成MD5/SHA1/SHA256校验值，优化发布流程，提升构建产物可追溯性。

服务器

Linux

JSON

2026采购季 | AI焕新·智启新局

coding

4核4G3M云服务器 新用户低至38元/年！

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

别再写改名脚本了，一个 Vite 插件搞定压缩、校验、自动哈希命名vite-plugin-pack-orchestrator-腾讯云开发者社区-腾讯云

别再写改名脚本了，一个 Vite 插件搞定压缩、校验、自动哈希命名vite-plugin-pack-orchestrator

别再写改名脚本了，一个 Vite 插件搞定压缩、校验、自动哈希命名vite-plugin-pack-orchestrator

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐