# @deno/eszip 中文文档

规范地址：https://npmcn.com/package/%40deno/eszip/

版本：0\.106\.0
npm 元数据更新时间：2026-03-24T12:40:30.134Z
中文译文更新时间：2026-11-11T22:40:00.603Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40deno/eszip
原文对照：https://npmcn.com/package/%40deno/eszip/?lang=original
项目主页：https://github.com/denoland/eszip#readme
源码仓库：https://github.com/denoland/eszip

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：8.8 MB，436 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：2 个
- 首次发布：2022-02-22T15:40:52.791Z
- 最新版本发布：2025-12-08T17:45:25.455Z
- 近 30 天下载量：68465（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：106（近 12 个月 2 个）

## 中文简介

一个可以下载 JavaScript 和 TypeScript 模块图表并将其存储在本地的特殊zip文件中的工具

## 安装

```sh
npm install @deno/eszip
```

也可以使用：`pnpm add @deno/eszip`、`yarn add @deno/eszip`、`bun add @deno/eszip`

## README

# 埃斯齐普

Eszip 格式允许您将 ECMAScript 模块图连续无损失 (由下列人士代理) [`deno_graph::ModuleGraph`](https://docs.rs/deno_graph/latest/deno_graph/struct.ModuleGraph.html))变成单一契约 文档.

Eszip文件格式的设计是紧凑而能流畅. 这个 允许高效地加载大型ECMAScript模块图表.

[https://eszip-viewer.deno.dev/ 互联网档案馆的存檔,存档日期2014-10-22](https://eszip-viewer.deno.dev/) 是检查 eszip 文件的工具.

## 实例

### 创建 eszip

```shell
cargo run --example eszip_builder https://deno.land/std/http/file_server.ts file_server.eszip2
```

### 查看 eszip 的内容

```shell
cargo run --example eszip_viewer file_server.eszip2
```

### 将 Eszip 装入 V8

```shell
cargo run --example eszip_load file_server.eszip2 https://deno.land/std/http/file_server.ts
```

## 文件格式

文件格式看起来如下:

```
Eszip:
| Magic (8) | Header size (4) | Header (n) | Header hash (32) | Sources size (4) | Sources (n) | SourceMaps size (4) | SourceMaps (n) |

Header:
( | Specifier size (4) | Specifier (n) | Entry type (1) | Entry (n) | )*

Entry (redirect):
| Specifier size (4) | Specifier (n) |

Entry (module):
| Source offset (4) | Source size (4) | SourceMap offset (4) | SourceMap size (4) | Module type (1) |

Sources:
( | Source (n) | Hash (32) | )*

SourceMaps:
( | SourceMap (n) | Hash (32) | )*
```

空出源/ 出源映射条目有一个优化 。 如果两者 抵消和大小设定为 0, 数据中没有条目和散列 该模块的章节.

## 发展

当打开公关确保通过运行重建瓦斯姆时:

```
deno task build
```

## 常见问题

### @deno/eszip 是什么？

一个可以下载 JavaScript 和 TypeScript 模块图表并将其存储在本地的特殊zip文件中的工具

### 如何安装 @deno/eszip？

在项目目录运行 npm install @deno/eszip，或使用 pnpm add / yarn add / bun add。

### @deno/eszip 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/deno\_\_eszip 是否存在。

### @deno/eszip 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @deno/eszip 可以商用吗？

@deno/eszip 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @deno/eszip 的下载量有多少？

根据 npm 官方下载统计，@deno/eszip 在 2026/10/12 – 2026/11/10 这 30 天内被下载 68,465 次，日均约 2,282 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @deno/eszip 还在维护吗？

最新版本 0\.106\.0 发布于 2025/12/09（11 个月前）；至今共发布 106 个版本，其中过去 12 个月发布了 2 个；首次发布于 2022/02/22。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。