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