Golang图像水印工具基于x/image和imaging库实现,支持文字(freetype+opentype)与图片(PNG透明叠加)水印,可旋转、调透明度、批量处理并保存为PNG/JPEG。

用 Golang 开发图像水印工具,核心是借助成熟的图像处理库(如 golang.org/x/image 和第三方库 github.com/disintegration/imaging)读取、修改、保存图片。添加文字水印需字体渲染支持(常用 github.com/golang/freetype),添加图片水印则是透明图层叠加。整个过程不依赖外部命令或图形界面,纯代码可控、可嵌入服务。
准备基础依赖与图像加载
先安装必要包:
go get golang.org/x/image/font/basicfontgo get github.com/golang/freetypego get github.com/disintegration/imaging-
go get golang.org/x/image/font/opentype(用于加载 TTF 字体)
使用 imaging.Open() 加载 JPG/PNG 等常见格式图片,它会自动识别格式并返回 *image.NRGBA。注意:若原图含 alpha 通道,务必保留;若无,文字/图片水印叠加时需手动处理背景兼容性。
添加文字水印(带旋转与透明度)
关键步骤是创建绘图上下文、加载字体、设置颜色与透明度、计算位置并绘制。推荐用 golang/freetype 渲染文字,它支持抗锯齿和任意角度旋转:
立即学习“go语言免费学习笔记(深入)”;
- 用
opentype.Parse()加载本地 .ttf 文件(如 NotoSansCJK 或 Arial) - 调用
freetype.NewContext()设置字号、DPI、RGB 模式和文字颜色(Alpha 值控制透明度) - 将目标图像转为
*image.RGBA,在指定坐标(建议居中偏下或四角)调用ctx.RenderString() - 若需斜向水印(如“CONFIDENTIAL”对角铺满),可用
imaging.Rotate()先生成小水印图,再平铺叠加
添加图片水印(PNG 透明图层叠加)
适合 logo 类水印。要求水印图是带 alpha 的 PNG,主图也需支持透明(*image.NRGBA 最稳妥):
- 用
imaging.Open("logo.png")加载水印图,再用imaging.Resize()缩放到合适尺寸(如主图宽高的 15%) - 用
imaging.Paste()将水印图粘贴到主图指定位置(如右下角留边 20px),第四个参数传入&image.Point{X: x, Y: y} - 若需半透明效果,可在粘贴前用
imaging.AdjustOpacity(watermark, 0.4)降低水印图不透明度 - 避免覆盖重要内容,可选加高斯模糊(
imaging.Blur(watermark, 1.0))或调整混合模式(需自行实现 multiply/dissolve)
保存结果与批量处理建议
处理完后用 imaging.Save() 输出为 PNG(保留 alpha)或 JPEG(自动丢弃 alpha,适合网页分发)。注意:Save 默认 JPEG 质量为 95,可传入 imaging.JPEGQuality(85) 显式控制。
- 单图处理直接调用流程函数即可;批量处理建议用
filepath.Walk()遍历目录,配合 goroutine 并发(限制并发数防 OOM) - 命令行交互可用
flag包接收参数:输入路径、水印类型、文字内容/字体路径、位置、透明度等 - 生产环境建议加错误检查(如字体文件是否存在、图片能否解码)、超时控制和内存限制(大图 resize 前可先缩略)










