Buffalo框架本身不提供图片水印功能，需集成imaging等库，通过ctx.FormFile("image")获取文件句柄，Open后读取图像，加载TTF字体，用imaging.DrawText添加带透明度的文字水印，并按原格式、原质量参数保存，避免二次压缩失真。
Buffalo 框架本身不提供图片水印功能，必须自己集成图像处理库（如 golang.org/x/image 或 github.com/disintegration/imaging）并在文件上传后手动调用。
Buffalo 中处理上传文件的典型流程是 ctx.Param("file") + ctx.File()？
不是。Buffalo 的文件上传依赖 ctx.Request().MultipartReader() 或更常见的 ctx.FormFile("image")（对应 HTML 表单中 <input type="file" name="image">）。拿到 *multipart.FileHeader 后，需先 Open() 读取内容，再保存或处理。
-
ctx.FormFile("image")返回文件元信息和一个可打开的句柄，不是直接可用的字节流 - 别直接用
ctx.File()——那是用于响应中发送文件，不是接收 - 临时路径不是必须的；你可以边读边处理，避免磁盘 IO（尤其对小图）
怎么用 imaging 库给上传的 PNG/JPEG 加文字水印？
核心是：读入 → 创建新图层 → 绘制文字/LOGO → 覆盖原图 → 写出。注意字体加载、坐标计算和透明度控制。
Buffalo框架 1.0.1
下载
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 文字水印需提前加载 TTF 字体（
truetype.Parse），不能用系统字体路径（跨平台不可靠） - 使用
imaging.DrawText时，Y 坐标是基线位置，不是顶部；建议用font.Metrics().Height推算安全偏移 - 透明度通过
color.RGBA{..., uint8(128)}控制，不是 alpha 通道单独设——RGBA 的 A 分量就是透明度 - GIF 和 WebP 不被
imaging原生支持；若需处理，得先转成 RGBA 图像再操作
fontBytes, _ := ioutil.ReadFile("assets/font.ttf")
f, _ := truetype.Parse(fontBytes)
face := truetype.NewFace(f, &truetype.Options{Size: 24})
img := imaging.Open(fileHeader.Filename) // 实际应从 fileHeader.Open() 读取
watermarked := imaging.Clone(img)
imaging.DrawText(watermarked, "© 2026", 50, 50, face, color.RGBA{255,255,255,128})
为什么加完水印后图片变模糊或颜色失真？
常见于 JPEG 二次编码：原始图用高质量保存，水印后又用默认参数（如 jpeg.Encode 的 &jpeg.Options{Quality: 75}）覆盖写入，导致压缩叠加。
- 读取时用
image.Decode得到 *image.NRGBA，绘制后务必用原格式、原质量参数重写 - 不要假设所有上传图都是 JPEG；检查
fileHeader.Header.Get("Content-Type")，按 MIME 类型分发处理逻辑 - PNG 无损，但加文字后若未保留 Alpha 通道（比如误转成
*image.RGBA），透明背景会变黑 - 避免在 Buffalo 的
app.ServeFiles()静态服务里直接返回处理中的临时文件——并发请求可能读到未写完的内容
真正麻烦的不是加水印这一步，而是如何让 Buffalo 的中间件或动作（action）在保存前统一拦截、识别“需加水印”的字段名（比如只对 avatar 和 product_image 字段触发），同时不破坏原有表单结构和错误处理流程——这部分没封装好，很快就会散落在十几个 Create 方法里。
