# @343dev/guetzli 中文文档

规范地址：https://npmcn.com/package/%40343dev/guetzli/

版本：1\.3\.0
npm 元数据更新时间：2026-06-25T10:53:58.124Z
中文译文更新时间：2026-11-05T22:24:55.001Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：3.5 MB，11 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=18\.17
- 运行依赖：0 个
- 首次发布：2024-10-22T10:36:59.034Z
- 最新版本发布：2026-06-25T10:53:58.029Z
- 近 30 天下载量：12526（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：5（近 12 个月 2 个）

## 中文简介

guetzli 二进制包装器

## 安装

```sh
npm install @343dev/guetzli
```

也可以使用：`pnpm add @343dev/guetzli`、`yarn add @343dev/guetzli`、`bun add @343dev/guetzli`

## README

# @ 343dev/guetzli (英语)

![Guetzli avatar: A graphic representation of a round biscuit with a scalloped edge, yellow in color, and topped with three evenly spaced red circles.](https://npmcn.com/package/%40343dev/guetzli/logo.svg)

[![npm](https://img.shields.io/npm/v/@343dev/guetzli.svg)](https://www.npmjs.com/package/@343dev/guetzli)

[谷歌/格兹利语](https://github.com/google/guetzli) 节点.js 二进制包装

获得支持:

-   操作系统平台 : `darwin`, (中文(简体) ), `linux`, (中文(简体) ), `win32`。 。 。 .
-   CPU 架构 : `arm64`, (中文(简体) ), `x64`。 。 。 .

## 导言

Guetzli是一款JPEG编码器,目的是在高视觉质量下达到优秀的压缩密度. 盖茨利所生成的图像一般比libjpeg所生成的质量相当的图像要小20-30%. 盖茨利只产生相继(非进步)的JPEG,因为它们提供的减压速度更快.

## 使用量

安装 :

```sh
npm i -g @343dev/guetzli
```

压缩 :

```sh
guetzli [flags] input_filename output_filename
# or
cat image.jpg | guetzli - - > result.jpg
```

## 命令行旗

-   `--verbose` ——打印出所有标准输出尝试的动词痕迹.
-   `--quality Q` - 视觉质量,以JPEG质量值(单位等同libjpeg质量)表示.
-   `--memlimit M` ——MB内存限制. 盖兹利若不能停留于限下会失败. 默认为 6,000 MB .
-   `--nomemlimit` ——不限制内存使用.

## 页:1

盖兹利使用大量的记忆. 您应该提供每输入图像 1 MPix 的 300MB 内存 .

盖茨利使用了大量的CPU时间. 您应该使用约 1 分钟的 CPU 每 1 MPix 输入图像 .

Guetzli 假设输入在 **sRGB 简介** 带有 **伽马为 2.2**. Guetzli 将忽略图像中任何色彩标注元数据.

盖茨利被设计用于高品质的图像上. 您应该总是倾向于提供未压缩的输入图像(例如,还没有用包括Guetzli在内的任何JPEG编码器压缩过). 虽然它也会对其他图像产生影响,但结果会更差。 你可以尝试压缩一个封闭的样本 高质量的图像.

JPEG 图像不支持α通道(透明). 如果输入是带有α通道的PNG,则在编码前会覆盖在黑色背景上.

## 常见问题

### @343dev/guetzli 是什么？

guetzli 二进制包装器

### 如何安装 @343dev/guetzli？

在项目目录运行 npm install @343dev/guetzli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 guetzli，可以用 npx guetzli 直接运行。

### @343dev/guetzli 支持 TypeScript 吗？

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

### @343dev/guetzli 支持 ESM 还是 CommonJS？

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

### @343dev/guetzli 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18\.17。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @343dev/guetzli 可以商用吗？

@343dev/guetzli 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @343dev/guetzli 的下载量有多少？

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

### @343dev/guetzli 还在维护吗？

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