# @343dev/optimizt 中文文档

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

版本：13\.0\.0
npm 元数据更新时间：2026-06-27T02:47:13.105Z
中文译文更新时间：2026-11-05T22:24:27.002Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：46.2 kB，25 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.22\.1
- 运行依赖：8 个
- 首次发布：2023-07-09T16:26:08.333Z
- 最新版本发布：2026-06-27T02:47:12.836Z
- 近 30 天下载量：12586（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：18（近 12 个月 4 个）

## 中文简介

CLI 图像优化工具

## 安装

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

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

## README

# @ 343dev/优化

![Optimizt logo: OK hand sign with Mona Lisa image between the fingers](https://npmcn.com/package/%40343dev/optimizt/docs/logo.png)

[![NPM Downloads](https://img.shields.io/npm/dw/%40343dev%2Foptimizt)](https://www.npmjs.com/package/@343dev/optimizt) [![npm](https://img.shields.io/npm/v/@343dev/optimizt.svg)](https://www.npmjs.com/package/@343dev/optimizt) [![Docker](https://img.shields.io/docker/v/343dev/optimizt?label=Docker)](https://hub.docker.com/r/343dev/optimizt)

**优化** 是一个命令行工具,有助于为网络准备图像.

它可以压缩PNG,JPEG,GIF,和SVG的失落或无损失,并为光栅图像创建AVIF和WebP版本.

## 理由

作为前端开发者,我们必须关注图片:压缩PNG和JPEG,去掉SVG的无用部分,为现代浏览器创建AVIF和WebP等. 有一天,我们厌倦了使用一堆应用软件来达到这个目的,并创造了一个工具来做我们想要的一切.

## 使用量

安装 :

```sh
npm install -g @343dev/optimizt
```

优化!

```sh
optimizt path/to/picture.jpg
```

## 命令行标记

-   `--avif` ——创建图像的AVIF版本.
-   `--webp` ——创建图像的WebP版本.
-   `-f, --force` ——即使AVIF和WebP版本已经存在,也要重新创建.
-   `-l, --lossless` ——优化无损失取而代之.
-   `-v, --verbose` ——显示详细的输出(例如跳过的文件).
-   `-c, --config` ——使用自定义配置文件而不是默认.
-   `-o, --output` ——将结果写入指定的目录.
-   `-p, --prefix` ——在优化文件名后添加前缀.
-   `-s, --suffix` ——为优化文件名添加后缀.
-   `-V, --version` ——显示工具版本.
-   `-h, --help` - 显示帮助信息.

## 用法实例

```bash
# optimize a single image
optimizt path/to/picture.jpg

# optimize multiple images losslessly
optimizt --lossless path/to/picture.jpg path/to/another/picture.png

# recursively create AVIF and WebP versions for all images in a directory
optimizt --avif --webp path/to/directory

# recursively optimize JPEG files in the current directory
find . -iname \*.jpg -exec optimizt {} +
```

## 损失和无损失之间的差异

### 损失( 过失)

提供文件大小缩小和最小视觉质量损失的最佳平衡.

### 无损失 (`--lossless` 旗帜)

-   **AVIF/网页**:使用无损压缩.
-   **PNG/JPEG/全球投资框架**: 以更大的文件大小为代价,使图像质量最大化.
-   **特别工作组**:两种模式的设置相同.

## 配置

图像处理杠杆 :

-   [锐口](https://github.com/lovell/sharp) 页:1 [JPEG 组合](https://sharp.pixelplumbing.com/api-output#jpeg), (中文(简体) ), [巴布亚新几内亚](https://sharp.pixelplumbing.com/api-output#png), (中文(简体) ), [网络P](https://sharp.pixelplumbing.com/api-output#webp),以及 [AVIF 亚军](https://sharp.pixelplumbing.com/api-output#avif)。 。 。 .
-   [斯维戈](https://github.com/svg/svgo) 为SVG.
-   [icle](https://github.com/kohler/gifsicle) 用于GIF.

> \[注\] 在 JPEG 的无损失模式中, [盖茨利](https://github.com/google/guetzli) 已使用。 重复优化可能会降低视觉质量.

默认设置在 [.优化cjs](https://npmcn.com/package/%40343dev/optimizt/.optimiztrc.cjs),包括所有支持的参数。 设置为 `false`。 。 。 .

使用时 `--config path/to/.optimiztrc.cjs`,将使用指定的配置文件。 如果没有 `--config` ,从当前目录向上递回查找 `.optimiztrc.cjs`。如果找不到,则适用默认值.

## 解决问题

### 错误如“sprawn guetzli ENOENT”.

确保 [忽略标注](https://docs.npmjs.com/cli/v6/using-npm/config#ignore-scripts) npm 选项已禁用 . 细节 : [音箱/优化/问题/9](https://github.com/funbox/optimizt/issues/9)。 。 。 .

## 发展

复制寄存器后, 启用 Git 钩子一次 :

```sh
npm run enable-git-hooks
```

此配置 Git 以使用来自 [{\\fn方正黑体简体\\fs18\\b1\\bord1\\shad1\\3ch2f2f2f}美国海军陆战队](https://npmcn.com/package/%40343dev/optimizt/.githooks) 目录.

## 夹克

### 预建图像

```bash
# pull latest
docker pull 343dev/optimizt

# pull specific version
docker pull 343dev/optimizt:9.0.2
```

### 手动构建

```bash
# clone repository
git clone https://github.com/343dev/optimizt.git
cd optimizt

# build image
docker build --tag 343dev/optimizt .
```

或者:

```bash
# build directly from GitHub
# ignores .dockerignore (see: https://github.com/docker/cli/issues/2827)
docker build --tag 343dev/optimizt https://github.com/343dev/optimizt.git
```

### 运行容器

```bash
# mount current directory to /src in the container
docker run --rm --volume $(pwd):/src 343dev/optimizt --webp ./image.png
```

## 一体化

优化工作与:

-   [JetBrains 接口](https://npmcn.com/package/%40343dev/optimizt/docs/jetbrains.md)
-   [视觉工作室代码](https://npmcn.com/package/%40343dev/optimizt/docs/vscode.md)
-   [次级文本 3](https://npmcn.com/package/%40343dev/optimizt/docs/sublime-text.md)
-   [GitHub 动作工作流程](https://npmcn.com/package/%40343dev/optimizt/docs/github.md)

## 文章

-   [anuwong.com (原始内容存档于2018-10-29)](https://anuwong.com/blog/2023-08-21-save-tons-of-gbs-with-optimizt/) ——上传前压缩文件,可保存吨GB. QQ
-   [Linux格式, 第277期(2021年7月)](https://www.linuxformat.com/archives?issue=277#:~:text=Kitchen%20Tales%2C%20zFRAG%2C-,Optimizt,-and%20SingleFileZ.) ——"优化"是理想的,可以减少图像的磁盘足迹而不会降低质量.

## 贷项

项目的可爱图片由下列人士制作: [伊戈尔·加里巴尔迪](http://pandabanda.com/)。 。 。 .

## 其他项目

-   📦 [哈罗德](https://github.com/343dev/harold) ——比较前端工程捆绑大小的 CLI 工具
-   🐳 [囚犯](https://github.com/343dev/jailbot) - 安装自动文件系统路径的多克容器包装器
-   📝 [马克-下行](https://github.com/343dev/markdown-lint) ——基于Pretier,Remark,和Typograf的Markdown代码样式linter
-   🔤 [语言工具-节点](https://github.com/343dev/languagetool-node) 由语言工具驱动的 CLI 拼写和语法检查器

## 常见问题

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

CLI 图像优化工具

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

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

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

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

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

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

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

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

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

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

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

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

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

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