Graphics2D截取图片前须验证图像非null且可读，校验裁剪坐标不越界，复用源图色彩模型，保存时注意格式限制与alpha通道处理。
用 Graphics2D 截取图片区域前，先确认图像是否可读取且非 null
直接调用 getGraphics() 或新建 BufferedImage 后立刻绘图，却忽略源图加载失败，是裁剪结果为空白或抛 NullPointerException 的最常见原因。Java 图像 I/O 默认不抛异常，ImageIO.read() 对损坏/不支持格式的文件会静默返回 null。
- 务必检查返回值：
BufferedImage src = ImageIO.read(new File("input.jpg")); if (src == null) throw new IllegalArgumentException("无法加载图片"); - 注意路径编码：Windows 下中文路径可能触发
FileNotFoundException，优先用getClass().getResource()或转为File.toURI() - 某些 WebP、HEIC 格式需额外加库（如
io.github.cdimascio:java-webp），否则ImageIO.read()也返回null
裁剪坐标和尺寸必须严格落在原图边界内，否则 BufferedImage.getSubimage() 抛 RasterFormatException
getSubimage(x, y, w, h) 看似最简，但它不做越界校验——只要 x + w > src.getWidth() 或 y + h > src.getHeight()，就直接崩溃。而用 Graphics2D 绘制时越界只是“画不出”，更难定位问题。
- 手动截断：用
Math.min(w, src.getWidth() - x)和Math.min(h, src.getHeight() - y)修正宽高 - 负坐标要归零：
x = Math.max(0, x); y = Math.max(0, y) - 如果 UI 允许拖拽选区，建议在绘制预览时就禁用超出边界的鼠标操作，而不是等裁剪时再处理
用 Graphics2D 绘制裁剪区域时，别漏掉 dispose() 和色彩空间继承
从源图创建新 BufferedImage 后获取 Graphics2D，若不设置渲染提示或忽略源图色彩模型，生成图可能出现色偏、透明通道丢失、文字锯齿等问题，尤其在 PNG 带 alpha 时。
- 创建目标图时复用源图类型：
new BufferedImage(src.getWidth(), src.getHeight(), src.getType())，避免硬写TYPE_INT_ARGB - 绘制前设置抗锯齿和渲染质量：
g2d.setRenderingHint(RenderingHints.KEY_INTERPOLATION, RenderingHints.VALUE_INTERPOLATION_BILINEAR); - 用完
Graphics2D必须g2d.dispose()，否则可能引发资源泄漏（尤其在循环批量处理时） - 裁剪小图再放大显示？别用
drawImage(..., SCALE_DEFAULT)，改用VALUE_INTERPOLATION_BICUBIC减少模糊
保存裁剪结果时，ImageIO.write() 不支持 WebP，且 JPEG 默认丢弃 alpha 通道
即使裁剪逻辑完全正确，保存环节也可能让结果“看起来失败”：透明背景变黑、细节发虚、文件打不开。这是因为 ImageIO 内置只支持 JPEG、PNG、GIF，且 JPEG 编码器默认强制转为 RGB。
立即学习“Java免费学习笔记（深入）”；
- PNG 保留 alpha：
ImageIO.write(cropped, "png", new File("out.png")) - JPEG 强制去透明：
BufferedImage rgb = new BufferedImage(cropped.getWidth(), cropped.getHeight(), BufferedImage.TYPE_INT_RGB); rgb.createGraphics().drawImage(cropped, 0, 0, Color.WHITE, null); - WebP 需引入第三方 writer，例如
com.twelvemonkeys.imageio:imageio-webp，然后注册插件并用"webp"格式名 - 注意输出路径父目录存在性：
out.getParentFile().mkdirs()，否则静默失败
实际裁剪逻辑本身并不复杂，真正卡住人的永远是图像加载状态、坐标越界、色彩模型错配和保存格式限制这四点。尤其是 alpha 通道和 WebP 这类“看似应该支持”的场景，Java 标准库的沉默行为很容易让人查半天配置。
