水印注入须待文件写入完成：监听create+write事件后，用os.stat两次检查文件大小是否稳定（间隔100ms），再按格式白名单（.jpg/.png/.pdf/.docx）和只读方式处理；pdf用水印需用gofpdf向量绘制，图片则依jpeg/png/webp特性分别处理；并发须用带缓冲channel限流。
水印注入必须在文件写入完成后再触发
Go 的 fsnotify 库监听文件事件时，Write 事件常在文件内容写入中途就发出，此时读取文件会得到截断或脏数据。尤其对图片、PDF 等二进制文件，直接处理极易损坏格式。
实操建议：
- 监听
Create+Write后，用os.Stat检查文件大小是否稳定（连续两次检查间隔 100ms，大小不变再处理） - 对常见类型加后缀白名单：
.jpg、.png、.pdf、.docx，忽略临时文件（如~$report.docx、.tmp） - 用
os.OpenFile(path, os.O_RDONLY, 0)打开只读句柄，避免与写入进程冲突
PDF 水印需用 gofpdf 而非图像叠加
把 PNG 水印“画”到 PDF 页面上，不是简单地把水印图贴在顶层——PDF 是向量格式，硬叠图层会导致缩放失真、打印无水印、文字选中异常。
实操建议：
- 用
gofpdf的AddPage+SetAlpha+Image实现半透明斜铺水印，每页单独注入 - 避免用
unidoc（需商业许可），免费方案优先选gofpdf或github.com/pdfcpu/pdfcpu/pkg/api（后者支持内容层插入，但水印需手动计算坐标） - PDF 处理前先调用
pdfcpu.ValidateFile检查结构完整性，防止因损坏 PDF 导致 panic
图片水印要区分 JPEG/PNG/WEBP 的编码路径
同一张水印图不能用同一种方式注入所有格式：JPEG 不支持透明度，PNG 需保留 alpha 通道，WEBP 支持动画但 Go 标准库不原生解码动画帧。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
实操建议：
- JPEG：用
image/jpeg.Decode读取 →draw.Draw叠加水印 → 写回时设jpeg.Options{Quality: 95}，避免二次压缩劣化 - PNG：用
image/png.Decode，叠加后必须用png.Encode且保持color.NRGBA类型，否则丢透明度 - WEBP：引入
h2non/bimg（基于 libvips），它支持无损叠加和元数据保留；标准库无法处理 WEBP
并发注入必须限制 goroutine 数量并隔离文件句柄
监听目录下大量文件快速生成时，若每个事件都起 goroutine，可能瞬间打开数百个文件句柄，触发系统级 too many open files 错误，且水印操作本身是 I/O 密集型，无节制并发反而降低吞吐。
实操建议：
- 用带缓冲的 channel 控制并发数（如
sem := make(chan struct{}, 4)），每次处理前sem ，完成后 <code> - 每个 goroutine 内部用
defer file.Close()，不要复用*os.File实例 - 对 PDF 和图片分别建两个 worker pool，因为它们依赖不同库、失败原因不同（如 PDF 解析失败 vs 图像 decode error）
真正难的不是加水印，而是判断“此刻文件是否已写稳”以及“该用哪条代码路径处理它”。类型判断错一次，就可能产出不可用文件；时机判断错一次，就可能注入空文件或损坏原文件。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
