C#怎么进行图像处理 ImageSharp库使用方法

ImageSharp 是现代 .NET 图像处理首选库,安全无 GDI+ 依赖、支持异步与内存友好;通过 NuGet 安装主包及可选扩展,支持多格式加载/保存、链式变换(Resize/Crop/Rotate 等)、Mutate 原地操作、文字图形绘制,并需注意像素格式、using 释放与异步加载。

ImageSharp 是一个开源、跨平台、高性能的 .NET 图像处理库,相比 System.Drawing(已不推荐用于 Web 环境),它更安全、无依赖系统 GDI+、支持异步、内存友好,是 C# 图像处理的现代首选。

安装 ImageSharp

通过 NuGet 安装核心包:

  • ImageSharp:主库(含基础加载/保存/变换)
  • 可选:ImageSharp.Drawing(绘图、文字、形状)
  • 可选:ImageSharp.Web(ASP.NET Core 集成,如动态缩略图中间件)

命令行安装:

dotnet add package SixLabors.ImageSharp

基础图像加载与保存

支持常见格式(JPEG、PNG、GIF、BMP、WebP 等),自动识别格式,无需指定扩展名。

  • 从文件加载:using var image = Image.Load("photo.jpg");
  • 从流加载:using var image = Image.Load(stream);
  • 保存为 JPEG(质量可控):image.Save("out.jpg", new JpegEncoder { Quality = 85 });
  • 保存为 PNG(默认无损):image.Save("out.png");

注意:所有操作都基于 Image(默认 32 位 RGBA 像素格式),也可显式指定其他像素类型(如 Image 灰度图)。

常用图像变换操作

链式调用,操作不修改原图(返回新图像),适合组合使用:

  • 调整尺寸:image.Clone(x => x.Resize(800, 600, ResizeMode.Max))(支持多种缩放模式)
  • 裁剪:.Crop(new Rectangle(100, 50, 400, 300))
  • 旋转:.Rotate(90)(角度,支持负值)
  • 翻转:.Flip(FlipMode.Horizontal)
  • 灰度化:.Mutate(x => x.Grayscale())Mutate 原地修改,节省内存)
  • 高斯模糊:.Mutate(x => x.GaussianBlur(sigma: 2f))

建议对简单变换优先用 Mutate,避免频繁克隆;复杂流水线可用 Clone + 链式。

绘制文字与图形(需 ImageSharp.Drawing)

添加包:dotnet add package SixLabors.ImageSharp.Drawing

  • 绘制文本:.Mutate(x => x.DrawText("Hello", font, color, new PointF(10, 10)))
  • 绘制矩形:.DrawRectangle(Pens.Solid(Color.Red, 2), rect)
  • 绘制圆角矩形、椭圆、路径等也均支持
  • 字体需先加载:var font = SystemFonts.CreateFont("Arial", 16);(或使用 FontCollection 加载自定义 .ttf)

基本上就这些。ImageSharp API 清晰、文档完善(官网有完整示例),上手不难但细节多——比如像素格式选择、内存释放(务必用 usingDispose())、异步加载(Image.LoadAsync)等,用熟后处理万级图片也没压力。