前言

在软件开发实践中，图像处理已从"可选功能"转变为"基础能力"。无论是 Web 应用中的用户头像上传、电商平台的商品图优化，还是自动化脚本中的批量图片转换，开发都需要一套可靠、高效且易于集成的图像处理方案。然而，许多现有工具要么依赖复杂环境（如安装 ImageMagick），要么功能单一、扩展困难。基于 .NET 9 构建，融合现代图像库的优势，提供零依赖、跨平台、高性能的全栈图像处理能力，真正让开发者"开箱即用"。

项目介绍

项目是一个开源的 C# 图像处理工具套件，采用模块化架构，包含核心类库、命令行工具（CLI）、Web API 服务、示例程序和完整的单元测试。项目充分利用 .NET 9 的新特性，支持原生 AOT 编译，可在 Windows、Linux 和 macOS 上无缝运行，无需额外安装任何图像处理运行时。

其设计目标明确：为 .NET 开发提供一套统一、稳定、高性能的图像处理基础设施，既能内嵌到应用程序中，也能作为独立工具或服务部署。

项目功能

1、格式转换：支持 JPEG、PNG、GIF、BMP、TIFF、WebP、AVIF 等主流格式互转，尤其对新一代 AVIF 格式提供完整支持。

2、尺寸调整：提供拉伸、保持宽高比、中心裁剪等多种模式，满足不同场景需求。

3、智能压缩：在视觉质量与文件体积之间取得平衡，显著减小图片大小。

4、图像裁剪：支持指定坐标裁剪或自动中心裁剪，精准控制输出区域。

5、缩略图生成：快速生成高质量缩略图，适配移动端或列表预览。

6、水印添加：支持文本或图片水印，9 种位置选项，透明度与缩放可调。

7、元数据清理：一键清除 EXIF、ICC、XMP 等隐私敏感信息，提升安全性。

8、颜色调整：可调节亮度、对比度、饱和度、色相、伽马值等参数。

9、信息提取：获取图像尺寸、格式、色彩空间等详细信息，支持 JSON 输出。

10、图像验证：通过扩展名、文件头或深度加载三种方式验证图片有效性。

项目特点

跨平台零依赖：基于 .NET 9 和托管图像库，无需安装外部工具。

AOT 原生性能：支持 Ahead-of-Time 编译，启动快、内存低、体积小。

多接口支持：提供 CLI、Web API、.NET 类库三种使用方式，灵活适配不同场景。

批量处理能力：所有 CLI 命令均配套批量版本，支持递归目录扫描与文件过滤。

现代格式优先：率先支持 AVIF，助力 Web 性能优化与带宽节省。

生产就绪：包含 180 个单元测试，覆盖核心路径，确保稳定性。

项目技术

技术栈兼顾性能与兼容性：

• 核心引擎：以 SixLabors.ImageSharp 为主力，处理 JPEG/PNG/WebP 等常见格式；

• AVIF 支持：通过 Magick.NET-Q16-AnyCPU 调用 ImageMagick 的 AV1 编码器，实现高质量 AVIF 转换；

• 架构设计：采用工厂模式与处理器分离，各功能模块（如裁剪、水印、压缩）高度解耦；

• 部署优化：支持单文件发布与 AOT 编译，生成的可执行文件可直接分发，无运行时依赖；

  

• 测试保障：基于 xUnit 构建测试套件，行覆盖率接近 70%，关键路径全覆盖。

项目代码

核心类库集成

using ImageGlider;
using ImageGlider.Enums;

// 格式转换
bool success = ImageConverter.ConvertImage("input.jpg", "output.png", quality: 85);

// 转换为 AVIF 格式（现代高效压缩）
bool avifSuccess = ImageConverter.ConvertImage("input.jpg", "output.avif", quality: 80);

// 从 AVIF 格式转换
bool fromAvif = ImageConverter.ConvertImage("input.avif", "output.png");

// 尺寸调整
bool resized = ImageConverter.ResizeImage("input.jpg", "output.jpg", 800, 600, ResizeMode.KeepAspectRatio);

// 图像压缩
bool compressed = ImageConverter.CompressImage("input.jpg", "compressed.jpg", quality: 70);

// 添加文本水印
bool watermarked = ImageConverter.AddTextWatermark("input.jpg", "watermarked.jpg", "© 2024", WatermarkPosition.BottomRight);

// 批量转换为 AVIF 格式
var avifResult = ImageConverter.BatchConvert("./photos", "./avif", ".jpg", ".avif", quality: 75);
Console.WriteLine($"AVIF 转换成功: {avifResult.SuccessfulConversions}/{avifResult.TotalFiles}");

// 批量处理
var result = ImageConverter.BatchConvert("./input", "./output", ".jpg", ".png", quality: 90);
Console.WriteLine($"成功转换: {result.SuccessfulConversions}/{result.TotalFiles}");

// 获取图像信息
var info = ImageConverter.GetImageInfo("image.jpg");
Console.WriteLine($"尺寸: {info.Width}x{info.Height}, 格式: {info.Format}");

// 图像文件验证
using ImageGlider.Utilities;

// 检测文件是否为有效图片（综合检测）
bool isValidImage = ImageValidator.IsValidImageFile("path/to/file.jpg");

// 启用深度验证（通过ImageSharp加载验证）
bool isValidWithDeepCheck = ImageValidator.IsValidImageFile("path/to/file.jpg", useDeepValidation: true);

// 仅检测文件扩展名
bool hasImageExtension = ImageValidator.IsValidImageExtension("file.png");

// 基于文件头检测（魔数签名）
bool isValidBySignature = ImageValidator.IsValidImageBySignature("path/to/file.jpg");

// 获取支持的图片格式列表
string[] supportedFormats = ImageValidator.GetSupportedExtensions();
Console.WriteLine($"支持的格式: {string.Join(", ", supportedFormats)}");

高级功能示例

using ImageGlider.Processors;
using ImageGlider.Core;

// 使用处理器工厂
var resizer = ImageProcessorFactory.CreateResizer();
var compressor = ImageProcessorFactory.CreateCompressor();
var watermark = ImageProcessorFactory.CreateWatermark();

// 链式处理
bool processed = resizer.ProcessImage("input.jpg", "temp.jpg", 800, 600) &&
 compressor.ProcessImage("temp.jpg", "final.jpg", 80);

项目结构

├── src/
│   ├── xxx/ # 核心类库
│   │   ├── Core/ # 核心接口和工厂
│   │   ├── Processors/ # 图像处理器
│   │   ├── Utilities/ # 工具类
│   │   ├── Enums/ # 枚举定义
│   │   └── ImageConverter.cs     # 主要API入口
│   ├── xxx.Cli/ # 命令行工具
│   │   ├── Commands/ # 16种命令实现
│   │   └── Program.cs # CLI程序入口
│   ├── xxx.WebApi/       # Web API服务
│   │   ├── Endpoints/ # API端点
│   │   ├── Services/ # 服务层
│   │   └── Program.cs # API程序入口
│   └── xxx.Example/      # 示例程序
│       └── Program.cs # 使用示例
└── tests/
    └── xxx.Tests/        # 单元测试
        ├── TestHelpers/         # 测试辅助工具
        └── *.cs # 180个测试用例

项目效果

实际使用中，表现出极高的易用性与效率。例如，将 100 张 JPEG 图片批量转换为 AVIF 并添加水印，仅需一条命令：

imageglider batch-convert -sd ./photos -od ./avif -se .jpg -te .avif -q 80
imageglider batch-watermark -sd ./avif -od ./final --text "© 2024" --position bottom-right

在 Web 服务中，前端上传图片后，后端通过调用核心类库几行代码即可完成压缩与格式转换：

ImageConverter.CompressImage("upload.jpg", "optimized.avif", quality: 75);

AOT 编译后的 CLI 工具启动时间低于 50ms，内存占用不足 20MB，非常适合嵌入自动化脚本或容器化部署。

项目源码

项目完全开源，安装方式多样：

• 全局工具安装：dotnet tool install --global xxx.Cli

• 源码构建：git clone 后 dotnet build

• 单文件发布：支持 Windows/Linux/macOS 多平台

• AOT 编译：进一步提升性能与启动速度

可直接引用 NuGet 包集成到项目中，也可运行 Example 查看典型用法。 

总结

项目不仅仅是一个图像处理工具，更是一套面向现代 .NET 开发的图像基础设施。它解决了传统方案依赖重、格式支持弱、部署复杂等痛点，以模块化、高性能、跨平台的设计理念，为桌面应用、Web 后端、自动化脚本等场景提供了统一且高效的解决方案。