使用教程

第一步

资源管理器右键菜单

7-Zip-zstd 安装完成后自动集成到 Windows 资源管理器的右键菜单。如果你熟悉官方 7-Zip，下面这些动作对你来说完全一致。

# 右键菜单中常见的动作：
- 添加到 xxx.7z                # 默认 Zstandard+级别 19
- 压缩到 xxx.7z 并发送        # 压缩完直接发邮件附件
- 解压到当前目录 /
- 解压到 xxx\                  # 自动创建同名文件夹

---

第二步

命令行基本用法

7-Zip-zstd 提供 4 个 CLI 变体：7z（完整功能，需要 .so 模块）、7zz（独立二进制，Linux/macOS 官方包）、7za（极简独立可执行）、7zr（专注 7z 格式的最小版）。

压缩（添加）

$ 7z a archive.7z folder/ # 默认 Zstd/级别19
$ 7z a -tzip archive.zip file.txt # 创建 zip 格式

解压（提取）

$ 7z x archive.7z # 完整解压，自动识别格式
$ 7z x archive.7z -o./output # 解到指定目录
$ 7z e archive.zst # 解压流式 .zst 文件

列出 / 测试

$ 7z l archive.7z # 查看压缩包内文件清单
$ 7z t archive.7z # 不解压，验证压缩包完整性

---

第三步

6 种算法参数速查

通过 -m0=Method 指定压缩方法、-mx=N 指定压缩级别。多线程参数 -mmt=N 可显著加速。

---

第四步

哈希校验

7-Zip-zstd 内置 17 种哈希算法（CRC32/64、MD2/4/5、SHA1/256/384/512、SHA3-256/384/512、XXH32/64、BLAKE2sp、BLAKE3），支持文件完整性校验、去重与签名验证。

$ 7z h -scrc=* archive.7z           # 计算包内每文件全部哈希
$ 7z h -scrc=SHA256 bigfile.bin     # 单文件 SHA-256
$ 7z h -scrc=XXH64,BLAKE3 iso/     # 多种哈希同时输出

---

第五步

与官方 7-Zip 共存

7-Zip-zstd 与官方版本互不冲突。推荐两种部署方式：

---

第六步

CI/CD 流水线集成

在 GitHub Actions / GitLab CI / Jenkins 中，7-Zip-zstd 可作为压缩制品的标准步骤使用。以下示例任选其一。

GitHub Actions

# .github/workflows/release.yml
- name: Install 7-Zip ZS
  run: |
    curl -L -o 7z.exe https://github.com/mcmilk/7-Zip-zstd/releases/download/\
v26.02-v1.5.7-R2/7z26.02-zstd-x64.exe
    7z.exe /S /D=C:\Tools\7z

- name: Compress artifacts with Zstandard
  run: C:\Tools\7z\7z.exe a -t7z -m0=zstd -mx=19 -mmt=4 app.7z dist\

Linux 脚本

#!/bin/bash
# 备份 MySQL 数据库并以 Zstandard 压缩
mysqldump --single-transaction mydb > db.sql
7zz a -t7z -m0=zstd -mx=19 -mx=22 db.7z db.sql
rm db.sql

Docker 容器内

# 在 alpine 镜像中快速使用
RUN apk add --no-cache curl xz
RUN curl -L -o /tmp/7zz.tar.xz https://github.com/mcmilk/7-Zip-zstd/releases/download/\
v26.02-v1.5.7-R2/7z26.02-zstd-linux-x64.tar.xz \
  && tar -xJf /tmp/7zz.tar.xz -C /usr/local/bin 7zz
CMD ["7zz", "a", "-t7z", "-m0=zstd", "-mx=19", "out.7z", "/data"]

---

第七步

常见问题