GetWebP - Local Image Converter Logo

文档

常见问题

关于 GetWebP CLI 的常见问题，按类别组织。

常见问题

关于 GetWebP CLI 的常见问题，按类别组织。

另请参阅： 入门 | 命令参考 | 故障排除

目录#

格式和转换#

GetWebP 支持哪些图像格式？#

GetWebP 将 JPG、JPEG、PNG、BMP 和 WebP 文件转换为优化的 WebP 格式。WebP 输入在目标质量级别重新编码，这可以进一步减少文件大小。查看 命令参考 了解完整的格式表。

转换后我的原始图像会被删除吗？#

不会。原始文件永远不会被修改或删除。转换后的 .webp 文件被写入原始文件旁边（或如果您使用 -o 则写入单独的目录）：

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

我可以控制输出质量吗？#

可以。默认质量是 80（范围 1-100）。较低的值产生更小的文件，但压缩伪影更多：

getwebp convert photo.jpg -q 95    # 近无损
getwebp convert photo.jpg -q 50    # 激进压缩

如果两个源文件产生相同的输出文件名会发生什么？#

如果文件如 photo.png 和 photo.jpg 在同一目录中，两者都会产生 photo.webp。GetWebP 检测到此冲突并警告您。将它们转换为单独的输出目录以避免冲突。查看 故障排除 了解详情。

许可和设备#

我如何在多台设备上使用 GetWebP？#

在每台设备上使用 getwebp auth <key> 激活相同的许可证密钥。Pro 许可证允许最多 3 个 CLI 设备和 3 个 WordPress 站点。要将许可证移到新机器，首先释放一个插槽：

# 在旧设备上
getwebp logout
 
# 在新设备上
getwebp auth XXXX-XXXX-XXXX-XXXX

您也可以从 在线仪表板 管理设备插槽。

我的许可证过期时会发生什么？#

GetWebP 恢复到免费计划行为：每次运行 20 个文件限制、文件之间 3 秒延迟，仅限串行处理。您的转换文件不受影响。要恢复完整功能，请在 getwebp.com/pricing 续期您的许可证并重新激活：

getwebp auth XXXX-XXXX-XXXX-XXXX

我如何检查我的当前许可证状态？#

运行 getwebp status 查看您的计划、过期日期和设备使用情况。添加 --json 获得机器可读的输出。查看 命令参考 了解示例输出。

性能#

为什么每次文件转换之间有延迟？#

在免费计划上，GetWebP 强制每个文件 3 秒延迟，并将每次运行限制为 20 个文件。这在 Pro 计划上被移除，Pro 还通过多个 CPU 核心启用并行处理。在 getwebp.com/pricing 升级。

我可以一次转换多少个文件？#

在免费计划上，最多 20 个文件每次运行。在 Pro 上，没有文件限制。您也可以使用 --concurrency 调整并行工作者（最多 32）：

getwebp convert ./images --concurrency 8

安装和平台#

运行 GetWebP 需要 Node.js 吗？#

不需要。GetWebP 作为 macOS（Apple Silicon 和 Intel）、Linux x64 和 Windows x64 的独立二进制文件提供。不需要运行时依赖。查看 入门 了解下载和设置说明。

macOS 使用 Gatekeeper 警告阻止二进制文件。我如何修复它？#

macOS 隔离从互联网下载的未签名二进制文件。移除隔离属性一次，警告将不会再出现：

xattr -cr /usr/local/bin/getwebp

有关分步说明，请查看 故障排除 -- macOS Gatekeeper。

配置文件存储在哪里？#

GetWebP 将其加密配置存储在 ~/.config/getwebp-nodejs/config.json。该文件使用您机器的硬件 ID 加密，因此无法复制到另一台设备。您可以使用 GETWEBP_CONFIG_DIR 环境变量覆盖位置。

离线和网络#

GetWebP 可以离线工作吗？#

可以。图像转换完全离线 -- 没有数据离开您的机器。网络连接仅用于三项操作：

  1. 许可证激活 (getwebp auth) -- 一次性
  2. 状态刷新 (getwebp status) -- 离线时回退到本地缓存
  3. 注销 (getwebp logout) -- 需要服务器解绑设备

激活后，许可证使用 JWT 令牌在本地验证。您可以在没有任何互联网连接的情况下转换图像。

如果我在离线时运行 getwebp status 会发生什么？#

CLI 从其上一次成功的服务器检查返回缓存的许可证数据。您将在 JSON 输出中看到 cached: true。转换继续正常工作。查看 故障排除 -- 状态显示"缓存"的数据。

卸载#

我如何卸载 GetWebP？#

  1. 移除二进制文件：

    # macOS / Linux
sudo rm /usr/local/bin/getwebp
 
# Windows
del C:\path\to\getwebp.exe

  2. 移除配置目录（可选）：

    # macOS / Linux
rm -rf ~/.config/getwebp
 
# Windows (PowerShell)
Remove-Item -Recurse -Force "$env:APPDATA\getwebp"

  3. 释放您的设备插槽（可选，如果有许可证）： 在删除二进制文件之前运行 getwebp logout，或从 仪表板 解绑设备。

仍然有问题？ 查看 故障排除指南 或访问 getwebp.com。