.NET原生不支持WebP编码，ImageSharp 2.x是跨平台稳定方案；转换需注意Alpha通道设置、质量参数、内存控制及服务器MIME配置。

WebP编码需要第三方库，.NET原生不支持

从 .NET 6 开始，System.Drawing 仍不支持 WebP 编码（仅部分解码），ImageSharp 是目前最稳定、跨平台、无系统依赖的方案。别试 System.Drawing.Common + GDI+，它在 Linux/macOS 上会直接抛 PlatformNotSupportedException，Windows 上也常因缺少编解码器失败。

• 推荐用 ImageSharp 2.x（最新稳定版），它内置 WebP 编码器，无需额外安装 native 库
• 避免用过时的 libwebp P/Invoke 封装，维护成本高、易出内存泄漏
• 若项目已用 SkiaSharp，它也能转 WebP，但体积大（含原生 skia 库），且默认不启用 WebP 编码，需手动调 SkiaSharp.WebP 包并注册编码器

用 ImageSharp 将 JPEG/PNG 转为 WebP（含质量与透明度控制）

核心是加载源图 → 创建 WebP 编码选项 → 保存。注意：PNG 带 Alpha 通道时，必须设 UseAlphaCompression = true，否则透明区域变黑；JPEG 没 Alpha，设了也无效，但无害。

C#

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

using SixLabors.ImageSharp;
using SixLabors.ImageSharp.Formats.Webp;

using var image = Image.Load("input.jpg");
image.Save("output.webp", new WebpEncoder
{
    Quality = 80,                    // 0–100，建议 75–90 平衡体积与画质
    UseAlphaCompression = true,      // PNG 必须开；JPEG 可忽略
    Lossless = false,                // true 时 Quality 被忽略，文件大但无损
    Method = WebpEncodingMethod.BestSpeed // 或 BestCompression / Default
});

• Quality = 80 对多数网页图足够，低于 60 易见块状伪影
• Lossless = true 适合图标、截图等小图，但 WebP 无损通常比 PNG 大 10%–30%，别盲目开启
• Method = BestSpeed 编码快但体积略大；BestCompression 更慢但省 5%–15% 空间，批量处理时建议设为 Default

批量转换时注意内存与线程安全

ImageSharp 的 Image.Load() 默认把整张图读进内存，10MB 的 PNG 可能占 40MB+ 托管内存（RGBA 各占 1 字节）。并发转多图时不加限制，容易触发 GC 频繁或 OutOfMemoryException。

• 用 using var image = Image.Load(...) 确保及时释放，别用静态 Image 实例
• 批量任务建议限流：每批最多 4 张图并发（CPU 核心数一半），避免 I/O 和 CPU 双瓶颈
• 大图（>4000px）考虑先缩放再转：image.Mutate(x => x.Resize(width, height, KnownResamplers.Lanczos3))，Lanczos3 锐度好，但比 Box 慢 3 倍
• 别在 ASP.NET Core Action 里直接转——同步 IO 会阻塞线程池，改用 SaveAsync() + FileStream

常见错误：输出文件为空或打不开

最常见三个原因：路径权限不足、目标目录不存在、编码器未正确配置。WebP 文件头损坏时，浏览器报 ERR_INVALID_RESPONSE，而不是明确提示格式错。

• 检查 output.webp 文件大小是否为 0 字节——大概率是目标路径不可写，或父目录不存在（Save() 不自动创建父目录）
• 确认输入文件不是 CMYK 模式 JPEG（ImageSharp 不支持），会静默失败，加 try/catch 捕获 ImageFormatException
• Linux 容器中若报 Unable to load shared library 'libwebp'...，说明误用了旧版封装；ImageSharp 2.x 完全托管，不依赖 libwebp.so
• WebP 文件被 Nginx/Apache 拒绝服务？检查服务器是否配置了 webp MIME 类型：image/webp

实际转换逻辑本身很简单，难的是边界情况：大图内存、透明通道处理、并发控制、部署环境兼容性。这些地方没卡点，剩下的就是套参数调参了。