Go image/draw 怎么把缩略图裁成固定比例

做头像、卡片封面或列表缩略图时，最容易出现的故障是：所有输出都要求 16:9 或 1:1，结果源图被直接压成固定宽高，人物和文字一起变形。image/draw 的正确用法是把“裁切”和“缩放”分开：先按目标比例从源图取一个不变形的 image.Rectangle，再把这块区域绘制到固定尺寸的目标画布。

要把缩略图裁成固定比例，先比较源图和目标比例，计算位于 src.Bounds() 内的中心裁切矩形；然后调用 draw.Draw(dst, dstRect, src, srcRect.Min, draw.Src)。这样不会拉伸，srcRect.Min 也不会因为默认为零点而导致取错区域。

先确认目标比例和裁切策略

固定比例缩略图通常有三种选择：裁切后铺满、保留整图并补边、直接拉伸。封面和头像更适合裁切后铺满，因为目标区域没有黑边；证件或带文字的图片则可能更适合补边。本文选择中心裁切，假设输出比例为 16:9，并保留源图像素比例。

判断方式很简单：比较 srcWidth/srcHeight 与 targetWidth/targetHeight。源图更宽，就减少左右区域；源图更高，就减少上下区域。不要先把源图压到目标尺寸再裁，那样已经把变形带进来了。

用 image.Rectangle 计算源图裁切窗口

image.Rectangle 的坐标来自源图自身的边界，不能想当然地从零开始。先取 src.Bounds()，再根据目标比例缩短较长的一边，最后把裁切框放到源图中心。下面的函数只计算窗口，不负责解码和绘制，方便单独复用。

func centerCrop(src image.Rectangle, targetW, targetH int) (image.Rectangle, error) {
	if src.Empty() || targetW 

这里使用乘法比较比例，避免浮点数边界误差。返回的矩形仍然在 src.Bounds() 内；如果业务需要偏上裁切，只需把中心偏移改成设计好的焦点坐标，但仍要做边界夹紧。

让 draw.Draw 对齐源点完成裁切

裁切窗口算好后，创建一个目标尺寸的 RGBA 画布。draw.Draw 的第二个参数是目标区域，第四个参数是源图起点；把 srcRect.Min 传进去，目标左上角就会对应源裁切框左上角。这里用 draw.Src，表示直接用源像素覆盖目标区域。

func cropTo(src image.Image, targetW, targetH int) (*image.RGBA, error) {
	if targetW 

这段代码完成的是“按比例裁切并复制”，不是高质量缩放。若源矩形和目标矩形尺寸不同，draw.Draw 不会替你做插值缩放；需要缩放时，应把缩放交给明确的图像缩放库或单独的缩放步骤，不能把裁切函数的职责混在一起。

补上尺寸限制和错误边界

裁切本身不等于安全。上传服务应在完整解码前限制文件字节数，解码后限制宽高和像素总量，再分配目标画布。targetW*targetH 也要用更宽的整数类型计算，避免大参数在 int 乘法中溢出。

按症状排查黑边、错位和拉伸

如果输出被拉伸，通常是跳过了源裁切，直接把整张图当成目标区域；如果画面偏移，先检查第四个参数是否写成了 image.Point{}，因为这会从源图左上角读取，而不是从裁切框起点读取；如果出现黑边，检查业务是否其实需要补边，以及目标画布是否在绘制前被清成了背景色。

还有一个常见误区：只把 srcRect.Min 调整了，却没有让 srcRect 的宽高匹配目标比例。排查时依次打印或记录源边界、裁切框、目标矩形和目标比例，先判断哪一个几何关系不成立，再决定是否需要缩放库。

常见问题

draw.Draw 能直接把图片缩放成任意尺寸吗？

不能把它当成缩放 API。它负责把源图绘制到目标区域；本文的用法是先裁切再复制，尺寸变化时不要默认存在高质量插值。

为什么 srcRect.Min 不能总是写成 image.Point{}？

当源图的裁切框不是从左上角开始时，零点会让 draw.Draw 读取错误区域。应传入裁切框左上角，除非你明确就是要从源图原点取图。

中心裁切一定适合头像吗？

不一定。人像或商品主体偏向一侧时，应根据焦点调整裁切框位置，并把最终矩形夹回源边界；中心裁切只是稳定的默认策略。

官方文档可继续查看 image/draw 的 Draw、DrawMask 和 Op 说明，以及 image 包的 Rectangle 定义。