为什么现在不推荐在新项目中用 AForge.NET 做图像处理
AForge.NET 已于 2019 年正式停止维护，
AForge.Imaging模块缺乏 .NET Core / .NET 5+ 兼容性，且多数类型（如
Bitmap依赖 GDI+）在 Linux/macOS 上无法运行。NuGet 包
AForge最后更新是 2018 年，引用
System.Drawing.Common时容易触发
PlatformNotSupportedException。如果你正在开发跨平台应用或需要长期维护，应直接转向
ImageSharp或
OpenCvSharp。
如果必须用 AForge.NET（比如维护老 WinForms 项目），怎么加载和显示图像
它不支持直接读取 PNG 透明通道或 WebP，只认 BMP/JPG/GIF（靠
System.Drawing.Bitmap底层）。常见错误是传入路径含中文或空格，导致
NullReferenceException—— 实际是
Bitmap构造失败后返回
null，而 AForge 未做校验。 用
new Bitmap(@"C:\img.jpg")加载，再转成
AForge.Imaging.UnmanagedImage显示时别直接用
PictureBox.Image = bitmap，要先调用
bitmap.Clone()防止资源被 AForge 锁住 避免在非 UI 线程调用
Bitmap.ToManagedImage()，会抛
InvalidOperationException
var bmp = new Bitmap(@"C:\test.jpg"); var unmanaged = UnmanagedImage.FromManagedImage(bmp); // 处理完记得释放 unmanaged.Dispose(); bmp.Dispose();
灰度化、二值化这些基础操作怎么写才不出错
AForge 的滤镜链（
FiltersSequence）默认复用输入内存，若多次调用同一实例，可能因前一步释放了像素内存而导致后续步骤崩溃。最稳妥方式是每次新建滤镜对象。
Grayscale.CommonAlgorithms.BT709是推荐的灰度算法，比
BT601更符合人眼感知 二值化用
OtsuThreshold比固定阈值更鲁棒，但要求输入已是灰度图（否则结果不可控） 所有滤镜的
Apply()方法返回新图像，原图不变；若想原地修改，得用
ApplyInPlace()，但仅部分滤镜支持
var grayFilter = new Grayscale(CommonAlgorithms.BT709); var grayImage = grayFilter.Apply(unmanaged); var otsu = new OtsuThreshold(); var binaryImage = otsu.Apply(grayImage); // 注意：这里必须是灰度图
替代方案怎么平滑迁移
把
AForge.Imaging.Filters对应功能映射到
ImageSharp时，注意坐标系差异：AForge 的
Rectangle参数是
(x, y, width, height)，而
ImageSharp的
Crop()是
(x, y, width, height)—— 表面一样，但 AForge 的
y在某些滤镜里会被反向解释（尤其旋转后），实际行为需实测。 灰度：用
image.Mutate(x => x.Grayscale())二值化：用
image.Mutate(x => x.Threshold(128))，或自定义
ThresholdProcessor高斯模糊：AForge 的
GaussianBlur默认 kernel=3，ImageSharp 要显式设
new GaussianBlurProcessor(3f)
真正难迁的是运动检测（
MotionDetector）和霍夫变换（
HoughLineTransformation）—— 这些在 ImageSharp 中没有等价实现，得换用
OpenCvSharp，且 API 完全不同。
