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<rgba32></rgba32>(默认 32 位 RGBA 像素格式),也可显式指定其他像素类型(如
Image<l8></l8>灰度图)。
常用图像变换操作
链式调用,操作不修改原图(返回新图像),适合组合使用:
调整尺寸: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 清晰、文档完善(官网有完整示例),上手不难但细节多——比如像素格式选择、内存释放(务必用
using或
Dispose())、异步加载(
Image.LoadAsync)等,用熟后处理万级图片也没压力。
