GetWebP CLI 入门

GetWebP CLI 从命令行将 JPG、PNG、BMP 和 WebP 图像批量转换为优化的 WebP 格式。

GetWebP CLI 入门

GetWebP CLI 从命令行将 JPG、PNG、BMP 和 WebP 图像批量转换为优化的 WebP 格式。用单个命令将图像文件大小减少 30-70% -- 无需云上传，基础使用无需订阅。

本指南将引导您完成安装、首次转换和可选的许可证激活。

想要了解完整功能概述？ 请查看 README。 需要完整的命令参考？ 请查看命令参考。

目录 #

系统要求
安装
- macOS
- Linux
- Windows
验证您的安装
转换您的第一张图像
转换图像目录
免费层级限制
激活 Pro 许可证
检查您的许可证状态
后续步骤

系统要求 #

要求	详情
操作系统	macOS (Apple Silicon 或 Intel)、Linux x64、Windows x64
Node.js	不需要 -- GetWebP 作为独立二进制文件提供
磁盘空间	~50 MB 用于二进制文件
网络	仅在许可证激活和状态检查时需要；转换完全离线

安装 #

从 Releases 页面下载适用于您平台的预构建二进制文件。

平台	二进制文件名
macOS Apple Silicon (M1/M2/M3/M4)	`getwebp-macos-arm64`
macOS Intel	`getwebp-macos-x64`
Linux x64	`getwebp-linux-x64`
Windows x64	`getwebp-windows-x64.exe`

macOS #

# 1. 重命名二进制文件
mv getwebp-macos-arm64 getwebp    # Intel Mac 上使用 getwebp-macos-x64
 
# 2. 使其可执行
chmod +x getwebp
 
# 3. 将其移到 PATH 上的目录
sudo mv getwebp /usr/local/bin/

处理 macOS Gatekeeper #

macOS 默认阻止未签名的二进制文件。如果您看到"无法打开，因为开发者无法验证"的警告，请移除隔离属性：

xattr -cr /usr/local/bin/getwebp

在您的第一个 getwebp 命令之前运行此命令。您只需执行一次。

Linux #

# 1. 重命名二进制文件
mv getwebp-linux-x64 getwebp
 
# 2. 使其可执行
chmod +x getwebp
 
# 3. 将其移到 PATH 上的目录
sudo mv getwebp /usr/local/bin/

Windows #

将 getwebp-windows-x64.exe 重命名为 getwebp.exe。
将 getwebp.exe 移到您的 PATH 上的目录（例如 C:\Tools\）。
如果该目录还不在您的 PATH 中，请添加它：
- 打开设置 > 系统 > 关于 > 高级系统设置 > 环境变量。
- 在系统变量下，选择 Path，点击编辑，并添加该目录（例如 C:\Tools\）。
打开一个新的终端窗口以使更改生效。

验证下载完整性（可选）#

每个版本都包含一个 .sha256 校验和文件。验证它以确认下载未被损坏或篡改：

# macOS / Linux
shasum -a 256 -c getwebp-macos-arm64.sha256
# 预期输出：getwebp-macos-arm64: OK

# Windows (PowerShell)
$expected = (Get-Content getwebp.exe.sha256).Split(' ')[0]
$actual   = (Get-FileHash getwebp.exe -Algorithm SHA256).Hash.ToLower()
if ($expected -eq $actual) { Write-Host "Verified OK" } else { Write-Host "MISMATCH" }

验证您的安装 #

getwebp -V

预期输出：

getwebp/1.2.1

如果您看到版本号，说明安装成功。如果您收到"command not found"，请确认该二进制文件在您的 PATH 列出的目录中。

转换您的第一张图像 #

将单个图像转换为 WebP：

getwebp convert photo.jpg

输出：

✓ photo.jpg
Done: 1 succeeded, 0 failed
Avg saved: 34.2%

转换后的文件 (photo.webp) 保存在原始文件的同一目录中。原始文件永远不会被修改或删除。

指定输出目录 #

getwebp convert photo.jpg -o ./output

转换后的文件写入 ./output/photo.webp。

调整质量 #

默认情况下，GetWebP 使用基于 SSIM 的自动质量。使用 --quality 指定固定质量（范围：1-100）。较低的值产生更小的文件，但压缩伪影更多：

getwebp convert photo.jpg --quality 95

转换图像目录 #

传递一个目录路径以转换其中所有支持的图像：

getwebp convert ./images -o ./webp-images

输出：

✓ images/hero.jpg
✓ images/banner.png
✓ images/icon.bmp
Done: 3 succeeded, 0 failed
Avg saved: 41.5%

包含子目录 #

添加 -r 以递归扫描子目录：

getwebp convert ./images -r -o ./webp-images

预览而不转换 #

使用 --dry-run 列出将被转换的文件而不写入任何输出：

getwebp convert ./images --dry-run

跳过已转换的文件 #

使用 --skip-existing 以避免重新转换已经有 .webp 对应文件的文件：

getwebp convert ./images --skip-existing

免费层级限制 #

GetWebP 无需许可证密钥即可工作，但有以下限制：

限制	值
每次运行的文件数	20
处理延迟	每个文件 3 秒
并行工作者	1（串行处理）

激活 Pro 许可证时，这些限制将被移除。

激活 Pro 许可证 #

在 getwebp.com/pricing 购买许可证。
使用您的许可证密钥运行 auth 命令：

getwebp auth XXXX-XXXX-XXXX-XXXX

输出：

Verifying license...
✓ Activated! Pro plan unlocked.

激活需要一次性网络连接。激活后，转换完全离线运行。许可证绑定到您的设备 -- 要将其移到另一台机器，请先运行 getwebp logout 以释放设备插槽。

检查您的许可证状态 #

getwebp status

输出：

Version    : 1.2.1
Mode       : Pro
License    : xxxx-xxxx-xxxx-A1B2
Expires    : 2027-04-01
Devices    : 1 / 5 used

如果您尚未激活许可证，输出将显示 Mode : Free。

对于机器可读的输出（在 CI/CD 管道中很有用）：

getwebp status --json

{"@timestamp":"...","@level":"info","@message":"GetWebP CLI 1.2.1","@module":"getwebp.cli","type":"version","data":{"getwebp":"1.2.1","ui":"1"}}
{"@timestamp":"...","@level":"info","@message":"Pro plan","@module":"getwebp.status","type":"status.reported","data":{"version":"1.2.1","plan":"pro","licenseKeySuffix":"A1B2","expiresAt":"2027-04-01T00:00:00.000Z","devicesUsed":1,"devicesLimit":5}}

后续步骤 #

主题	链接
完整命令参考	命令参考
退出代码和重试指导	退出代码
功能对比（Free vs Pro）	README -- 计划对比
定价和升级	getwebp.com/pricing
管理设备和许可证	getwebp.com/dashboard