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/imaginggo get golang.org/x/image/font/opentype(用于加载 TTF 字体)使用 imaging.Open() 加载 JPG/PNG 等常见格式图片,它会自动识别格式并返回 *image.NRGBA。注意:若原图含 alpha 通道,务必保留;若无,文字/图片水印叠加时需手动处理背景兼容性。
关键步骤是创建绘图上下文、加载字体、设置颜色与透明度、计算位置并绘制。推荐用 golang/freetype 渲染文字,它支持抗锯齿和任意角度旋转:
opentype.Par
se() 加载本地 .ttf 文件(如 NotoSansCJK 或 Arial)freetype.NewContext() 设置字号、DPI、RGB 模式和文字颜色(Alpha 值控制透明度)*image.RGBA,在指定坐标(建议居中偏下或四角)调用 ctx.RenderString()
imaging.Rotate() 先生成小水印图,再平铺叠加适合 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 包接收参数:输入路径、水印类型、文字内容/字体路径、位置、透明度等