用 image/draw 和 golang.org/x/image/font 加文字水印需设对 freetype.size（单位 1/64 磅）、显式调 ctx.setdpi(72)、y 坐标加基线偏移；批量处理须复用 font/context/缓冲区、限制并发、过滤后缀、统一 color.nrgba 模型并预合并 alpha。
直接上结论：用标准库 image/draw + golang.org/x/image/font 做文字水印，90% 的模糊、偏移、黑块问题都出在 freetype 渲染参数没设对；批量处理时内存暴涨，根本原因是每张图都 new 一个大位图且没复用缓冲区。
freetype.Size 单位是 1/64 磅，不是像素
传 16 不代表 16px 字号，而是 16/64 = 0.25 磅 ≈ 0.34mm，几乎不可见；传 1024 则是 16 磅，但若没调 ctx.SetDPI(72)，实际渲染尺寸会严重失真。
- 正确做法：字号按目标像素反推，比如要 24px 文字，设
face.SetSize(24 * 64) - 必须显式调
ctx.SetDPI(72)（或 96，匹配显示环境），否则 freetype 按默认 72dpi 计算，而图像坐标系是像素，单位错位就发虚 - 起始 y 坐标别直接用
y，得加基线偏移：y + face.Metrics().Ascent.Round()，否则文字整体上移或顶部被截 -
freetype.ParseFont和freetype.NewContext必须提前提取复用，禁止在循环里反复调用
image.Decode 报 invalid format 或 unknown format
标准库默认只注册 image/png，jpeg 和 gif 解码器需显式导入，否则 image.Decode 直接返回 nil, err；更麻烦的是，有些 JPG 实为 Exif 封装或 CMYK 编码，image/jpeg 会拒绝解析。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 必须加
import _ "image/jpeg"和import _ "image/png"（下划线不能少） - 优先用
image.Decode自动识别格式，别硬写jpeg.Decode - 对可信源图片，可加
jpeg.WithDecodeConfig(true)绕过部分校验 - 顽固 case 改用
github.com/disintegration/imaging，它内置宽容 JPEG 解码器，能啃下 CMYK 和带 ICC 的图 - 批量前用
filepath.Ext(path)过滤后缀，避免os.Open误读非图文件导致 panic
draw.Over 透明度失效、背景变黑、半透明变实心
draw.Over 是 Porter-Duff 操作，但要求源图与目标图的 color.Model 兼容。常见错配：原图是 color.NRGBA，水印图却是 image.NewRGBA（alpha 默认全 0），或两者 alpha 位宽不同（如 NRGBA64 vs RGBA）。
- 统一用
image.NewNRGBA创建水印画布（8-bit alpha，兼容性最好） - 绘制后手动设 alpha：
dst.SetNRGBA(x, y, color.NRGBA{r, g, b, 128})，别依赖初始化值 - 叠加改用
draw.DrawMask+draw.Over，传入 mask 图像（可复用同一张 mask） - JPEG 输出前必须合并 alpha：先
draw.Draw(dst, src.Bounds(), src, image.Point{}, draw.Src)，再贴水印，否则 alpha 通道丢失导致背景黑
并发 OOM、goroutine 泛滥、CPU 打满
一张 4K 图解码后是 ~12MB 的 *image.NRGBA，100 张并发就是 1.2GB 内存；每个 goroutine 都 new 位图、new context、ParseFont，GC 压力爆炸。
- 限制并发数：
runtime.GOMAXPROCS(4)或用带缓冲的 channel 控制 goroutine 数量（如sem := make(chan struct{}, 4)） - 缩放主图再处理：用
imaging.Resize把 4K 图压到 1200px 宽，内存直降 70% - 复用
sync.Pool缓冲位图：var bufPool = sync.Pool{New: func() interface{} { return image.NewNRGBA(image.Rect(0, 0, 1024, 1024)) }} - 避免在循环里
os.Open+image.Decode后不defer file.Close()，文件句柄泄漏比内存还快
真正难的不是“怎么加”，而是“怎么让每张图都稳定清晰、每批任务都不崩”。freetype 的 DPI、基线、Size 单位这三处，漏掉任何一个，文字水印就大概率糊成一片；而并发控制和缓冲复用，不是锦上添花，是批量跑起来的前提。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
