禁用 system.drawing.common 生成水印,因其在 linux/macos 易崩溃、.net 6+ 已过时且易致 gdi+ 句柄泄漏;应使用 graphics.fromimage(bitmap) 获取安全 graphics 实例,严格按 graphics.dispose() 后 bitmap.dispose() 释放资源。

别在 Web API 或后台服务里用 System.Drawing.Common 动态生成带水印的图片——它在 Linux/macOS 容器中大概率崩溃,在 .NET 6+ 中已过时,且 GDI+ 句柄泄漏会导致批量处理中途抛 OutOfMemoryException。
Graphics 对象从哪来才安全
直接 new Graphics() 会立刻报 NotSupportedException;Control.CreateGraphics() 返回的实例是临时的,窗体重绘就清空,不适合生成持久图片。真正可控、可释放的来源只有:Graphics.FromImage(bitmap)。
- 必须先
new Bitmap(width, height)或Bitmap.FromFile()加载原图,再传给FromImage - 绘图完成后,**先**
graphics.Dispose(),**再**bitmap.Dispose();顺序反了可能触发“对象已被释放”异常 - 在
Paint事件里拿到的e.Graphics是系统托管的,禁止Dispose(),也不该缓存复用
DrawString 文字水印糊、歪、切边的根因与解法
不是字体选得不好,而是没校准坐标系和渲染质量。固定字号(如 new Font("Arial", 12))在不同 DPI 或尺寸图片上必然失真。
- 字号按短边动态算:
float fontSize = Math.Max(8, Math.Min(img.Width, img.Height) * 0.04f); - 必须设
graphics.TextRenderingHint = TextRenderingHint.ClearTypeGridFit;(Windows)或AntiAliasGridFit(跨平台兼容) - 旋转斜水印前,先
graphics.TranslateTransform(centerX, centerY)移动原点,再RotateTransform(-30),否则文字一半被裁掉 - 透明度用
Color.FromArgb(100, 255, 255, 255),别用Brushes.White这类不透明预设
Logo 水印贴上去发白、拉伸、边缘泛光
问题不在 DrawImage 函数本身,而在源图格式、缩放逻辑和像素格式匹配。
- Logo 必须是带 Alpha 通道的 PNG,加载后验证:
logo.PixelFormat == PixelFormat.Format32bppArgb - 目标图若是 JPEG,叠加前务必转成
PixelFormat.Format32bppArgb,否则透明区域变黑底 - 缩放不用
DrawImage(destRect)粗暴拉伸;应手动计算srcRect和destRect,保持宽高比,调用DrawImage(logosrc, destRect, srcRect, GraphicsUnit.Pixel) - 每次用完
Bitmap logo = new Bitmap(path)后立刻logo.Dispose(),循环加水印时不释放,几十张图后 GDI+ 句柄就耗尽
Save 后水印变淡、发灰、甚至消失
JPEG 不支持 Alpha 通道,这是最常被忽略的底层限制。你画的是半透明文字,但保存时被强制合成到白底上,看起来就像“没了”。
- 要保留透明效果,必须存为 PNG:
bitmap.Save(path, ImageFormat.Png) - 若必须输出 JPEG,得提前合成:新建白色背景
Bitmap→DrawImage原图 →DrawString水印 → 再保存 - JPEG 编码质量低于 85 就会抹掉半透明边缘细节;用
GetJpegEncoder()获取编码器,EncoderParameter(Encoder.Quality, 90L)才够用 - 别依赖文件扩展名自动推断格式:
image.Save("a.jpg")可能误用 PNG 编码器,改用显式ImageFormat.Jpeg
真正难的不是“怎么画”,而是每一步都要对齐 GDI+ 的资源生命周期、像素格式契约和编码器语义——少一个 Dispose(),少一次 SetResolution(96, 96),少一次 Alpha 格式转换,批量任务就可能在第 217 张图上静默失败。










