magick.net需安装含完整编解码器的版本（如q8-hdri-anycpu）并调用magicknet.initialize()初始化，psd需coalesce()合成图层，多页/帧文档须用magickimagecollection加载，文字绘图应指定字体绝对路径及索引，大图需及时dispose并优先流式处理。
Magick.NET 安装后 MagickImage 构造失败，报“Unable to open image”
常见现象是读取 PSD、WEBP、HEIC 或带图层的 TIFF 时直接抛异常，不是文件路径错，而是解码器没加载。Magick.NET 默认只启用基础格式（PNG/JPEG/GIF），其余需显式注册。
- 安装对应扩展包：
Magick.NET-Q8-AnyCPU只支持基础格式；必须换用Magick.NET-Q8-HDRI-AnyCPU或带-OpenMP后缀的版本（含完整编解码器） - 代码里加一句初始化：
MagickNET.Initialize();，放在Main()开头或应用启动处，否则部分格式（尤其 HEIC/WEBP）即使有 DLL 也识别不了 - PSD 文件默认不自动合并图层——要用
image.Coalesce();才能拿到合成后的像素，否则读出来可能是空或单个图层
处理多页 PDF 或动画 GIF 时，Read 只返回第一页/第一帧
Magick.NET 把多帧/多页文档当集合处理，Read 方法默认只加载首项。想遍历所有页或帧，得用集合读取方式。
- 用
new MagickImageCollection()加载：var coll = new MagickImageCollection("document.pdf");，然后coll.Count是页数，coll[0]是第一页 - PDF 转图建议指定密度避免模糊：
coll.Read("file.pdf", new PdfReadDefines { Density = 150 });，Density单位是 DPI，低于 100 文字容易锯齿 - 动图保存时别漏
coll.Write("out.gif")——直接对单帧image.Write()会丢帧；还需设循环次数：coll.AnimationDelay = 10; coll.Looping = 0;
Drawables 绘图文字乱码、位置偏移
中文或特殊字体不显示，通常不是字体路径问题，而是 Magick.NET 内部字体渲染链路未适配系统字体缓存或编码。
- 别依赖系统字体名（如 "微软雅黑"），改用绝对路径加载：
draw.Font = @"C:\Windows\Fonts\msyh.ttc";，注意 TTC 是字体集合，要带索引：draw.Font = @"C:\Windows\Fonts\msyh.ttc[0]"; -
Drawables.Text()的坐标是左下角基线位置，不是左上角——和常规 UI 坐标系相反，Y 值越大，文字越往下。调试时先画个draw.Rectangle(10, 10, 20, 20)对齐参考 - 文字抗锯齿在高分屏上可能失效，强制开启：
draw.StrokeAntiAlias(true); draw.FillAntiAlias(true);
内存暴涨或处理大图时 OutOfMemoryException
Magick.NET 默认把整张图加载进托管内存，一张 8000×6000 的 32bit PNG 就占约 192MB，叠加多次操作极易触发 GC 压力或直接崩溃。
- 用
Dispose()显式释放：每个MagickImage实例用完立刻调用，别等 GC；集合类同理：coll.Dispose(); - 大图优先走流式处理：
using var stream = File.OpenRead("big.tiff"); var image = new MagickImage(stream);，避免一次性读全文件到内存 - 缩放前先用
image.Resize(new Percentage(25))比直接image.Resize(2000, 1500)更省内存——百分比模式内部会做采样优化，而目标尺寸模式强制全解码再裁剪
最麻烦的是 PSD 图层混合模式和矢量蒙版——Magick.NET 不解析这些，直接丢弃或转为栅格化结果。真要保真处理，得先用 Photoshop 脚本导出合并层，别指望库自动搞定。
