ImageSharp 的 Image.Load 抛出 “No decoder found” 错误是因为未指定格式且无法自动探测流内容；推荐显式指定解码器（如 JpegDecoder）或先用 Image.DetectFormat 探测格式。
ImageSharp 不再推荐用 Image.Load 直接读取流而不指定格式，否则在 Web 场景下容易因 MIME 类型缺失或不匹配导致解码失败。
为什么 Image.Load 会抛出 “No decoder found” 错误
ImageSharp 默认只注册了常见格式的解码器（如 PNG、JPEG），但不会自动探测流内容。当传入一个没有文件扩展名、无 Content-Type 头的 Stream（比如从 HttpRequest.Body 读取的原始字节），Image.Load 无法判断该用哪个解码器，直接报错。
- 错误典型信息：
No decoder found for the provided stream. - 常见于 ASP.NET Core 中接收前端上传的
IFormFile或Stream时未显式指定格式 - 即使文件是 JPEG，若没告诉 ImageSharp “请用 JPEG 解码器”，它就不会尝试
正确加载未知来源图片的两种方式
核心原则：**让解码器明确知道你期望什么，或者让 ImageSharp 自动探测一次头部字节**。
- 方式一（推荐）：用
Image.Load+IConfiguration显式指定格式using var image = Image.Load<rgba32>(stream, new JpegDecoder()); // 强制用 JPEG</rgba32>
或根据文件头动态选：var format = Image.DetectFormat(stream);<br>using var image = Image.Load<rgba32>(stream, format);</rgba32>
- 方式二：用
Image.Load的重载传入Configuration并启用自动探测（需手动注册所有解码器）var config = new Configuration().AddDecoders(JpegDecoder(), PngDecoder(), GifDecoder());<br>using var image = Image.Load<rgba32>(stream, config);</rgba32>
Resize 后图片变模糊？检查 Resampler 和 SizeMode
默认的 Resize 使用 Box 重采样器，适合缩略图但不适合高质量等比缩放；同时 SizeMode 选错会导致拉伸失真。
-
Resampler.Lanczos3是平衡质量与性能的常用选择，比默认的Box清晰得多 -
SizeMode.Crop会裁剪，SizeMode.Max保持比例并限制最大边长，别混用 - 示例（生成 300×300 居中裁切缩略图）：
image.Mutate(x => x<br> .Resize(new ResizeOptions<br> {<br> Size = new Size(300, 300),<br> Mode = ResizeMode.Crop,<br> Sampler = Resampler.Lanczos3<br> }));
保存为不同格式时注意编码器参数和内存泄漏
Image.Save 默认使用有损压缩（如 JPEG 的 75% 质量），且若未释放 Image 或未关闭输出流，可能引发 ObjectDisposedException 或内存堆积。
- JPEG 常用参数：
new JpegEncoder { Quality = 90 } - PNG 透明通道需确保像素类型支持 Alpha（如
Rgba32，不用Rgb24） - 务必用
using包裹Image，且Save的Stream必须可写、未被其他地方持有引用 - 错误写法：
image.Save(outputStream)后继续用image——Mutate后原图状态已变，再次 Save 可能异常
最常被忽略的是：在 ASP.NET Core 中返回图片响应时，Image.Save 写入 HttpContext.Response.Body 前，必须先清空 Response.ContentLength 并设置正确的 ContentType，否则浏览器可能拒绝渲染或下载为空。
