Java AWT 添加文字水印必须使用Graphics2D并配置抗锯齿与透明色，确保目标图类型为TYPE_INT_ARGB，正确计算drawString坐标（y=基线，需用getAscent()校正），水印图应缓存而非每次重绘重建。
Java AWT 绘图添加文字水印时，Graphics2D 必须开启抗锯齿和设置透明度
直接用 Graphics 画文字，水印要么发虚、要么完全不透明盖住原图——这是因为默认的绘图上下文没启用渲染提示，且 setColor() 不支持 alpha 通道。必须升级到 Graphics2D 并手动配置。
- 先调用
createGraphics()得到Graphics2D实例，别直接用getGraphics() - 立刻设置
g2.setRenderingHint(RenderingHints.KEY_TEXT_ANTIALIASING, RenderingHints.VALUE_TEXT_ANTIALIAS_ON) - 用
g2.setColor(new Color(r, g, b, alpha))（注意第四个参数是透明度，0–255），不能用setComposite()后再填纯色——那会把整块区域变半透，不是文字本身带透明 - 字体大小建议 ≥16，小字号在缩放或低DPI图上极易糊成一团灰
用 BufferedImage 加载图片后，TYPE_INT_ARGB 类型是加水印的前提
如果原始图是 JPEG（TYPE_INT_RGB），直接在上面 drawString，透明色会被强制转成黑色或白色，水印“消失”其实是被填实了。必须确保目标图像支持 alpha 通道。
- 加载后检查类型：
img.getType() == BufferedImage.TYPE_INT_ARGB，否则用new BufferedImage(w, h, BufferedImage.TYPE_INT_ARGB)创建新画布 - 用
g2.drawImage(srcImg, 0, 0, null)把原图完整拷贝过去，别漏这步——否则只画了水印，原图没了 - Swing 的
JLabel.setIcon()显示时若看到黑底，大概率是类型没转对，不是代码逻辑错
drawString() 坐标算不准？记住 y 是基线位置，不是顶部
写 g2.drawString("©2024", 10, 10)，文字几乎全在画布外——因为 y=10 指的是文字“基线”纵坐标，而大写字母顶部（ascent）通常在基线上方 10–15 像素。肉眼看到的“贴顶”其实是文字被截了一半。
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- 用
FontMetrics fm = g2.getFontMetrics()获取当前字体度量 - 真正让文字顶部离画布顶边 10 像素：y =
10 + fm.getAscent() - 想居中水印？x =
(width - fm.stringWidth(text)) / 2，但 y 要用height/2 + fm.getAscent()/2，不是简单除以 2 - 旋转水印时，
g2.rotate()会影响后续所有绘制，记得g2.dispose()前用g2.rotate(-angle)回正，或用g2.transform(AffineTransform.getRotateInstance(...))配合g2.setTransform(oldTx)
Swing 界面里实时预览水印，别在 paintComponent() 里反复创建 BufferedImage
每次重绘都 new 一张图、draw 一遍，UI 会卡顿，内存飙升。Swing 的绘制是高频触发的，不是“点一下才画一次”。
立即学习“Java免费学习笔记（深入）”；
- 水印图应作为类字段缓存：
private BufferedImage watermarkedImage; - 只在用户改文字/位置/透明度后，调用一次生成逻辑，然后
repaint() - 在
paintComponent()里只做g.drawImage(watermarkedImage, 0, 0, this)—— 这才是轻量级绘制 - 如果水印要随窗口缩放，别在 paintComponent 里 resize 图像，而是监听
ComponentListener.componentResized()，按需重建缓存图
实际最麻烦的从来不是“怎么画”，而是“什么时候画、画在哪张图上、这张图有没有 alpha、坐标系到底怎么算”。尤其当水印要叠加在用户上传的任意格式图片上时，BufferedImage 类型转换和 Graphics2D 的状态管理，比画几行字花的时间多得多。
