Go image.Image Bounds 处理非零原点图片的坐标与尺寸

处理 Go 图片时，image.Image.Bounds() 返回的不是“宽高”，而是一个像素坐标域。最容易出错的地方是把 Max.X、Max.Y 直接当成宽高；当图片的原点不是 (0,0) 时，这样做会漏读像素，甚至把合法坐标判成越界。正确做法是保留 Min 和 Max，用 Dx()、Dy() 计算尺寸。

官方资料：https://pkg.go.dev/image#Image

一、先把 Bounds 当作坐标域而不是图片宽高

image.Image 接口的 Bounds() image.Rectangle 描述了 At(x, y) 可以返回非零颜色的区域。矩形的 Min 是左上角，Max 是右下角的开区间端点，所以有效横坐标是 [Min.X, Max.X)，纵坐标是 [Min.Y, Max.Y)。

例如一个范围为 (10,20)-(110,70) 的矩形，宽度是 100，高度是 50，而不是 110 和 70。访问右下角附近的最后一个像素时，应使用 (109,69)；(110,70) 已经位于范围外。

二、用 Min、Max 和 Dx/Dy 计算真实坐标

遍历图片时，循环边界应直接使用矩形的 Min 和 Max。如果要取中心点，也不能把坐标从零开始计算，而应从 Min 加上尺寸的一半：

package main

import (
	"fmt"
	"image"
)

func main() {
	// 非零原点只用于说明坐标域；Max 是右下角开区间端点。
	b := image.Rect(10, 20, 110, 70)
	width, height := b.Dx(), b.Dy()
	center := image.Point{X: b.Min.X + width/2, Y: b.Min.Y + height/2}

	// 从 Min 开始、到 Max 之前结束，避免把开区间端点当成像素。
	for y := b.Min.Y; y 

这段代码的结果是宽 100、高 50、中心点约为 (60,45)。这里的关键不是输出值，而是尺寸和坐标分别由 Dx/Dy、Min 提供。

三、把非零原点传给裁剪与像素访问

需要复制或裁剪图片时，目标画布通常应使用源图的 Bounds。这样可以保留原图的坐标语义；如果强行创建 image.Rect(0, 0, width, height)，像素内容虽然可能被复制，坐标却已经改变。

func copyWithSameBounds(src image.Image) *image.RGBA {
	b := src.Bounds()
	// 目标画布沿用源图 Bounds，保留非零 Min 坐标。
	dst := image.NewRGBA(b)
	for y := b.Min.Y; y 

裁剪矩形也应先与源图 Bounds 求交，再交给后续逻辑。这样既能保留合法的非零坐标，也能避免外部输入把读取范围推到图片之外。

四、边界检查清单与常见误区

还要留意空矩形：当 Max.X 或 Max.Y 时，不要继续假设存在像素。图片解码后先读取 Bounds，再决定分配、遍历和裁剪范围，边界语义就不会在函数之间丢失。

相关问题

为什么不能把 Max.X 当成图片宽度

因为 Max.X 是坐标端点，不是从零开始计数的长度；只有在 Min.X 恰好为零时，两者才可能看起来相同。

At(x,y) 的最后一个合法坐标怎么得到

横坐标是 Max.X-1，纵坐标是 Max.Y-1，前提是对应维度非空。

创建新图片时什么时候可以改成零原点

只有在你明确要建立新的局部坐标系，并同步转换所有裁剪矩形、像素坐标和后续调用方时，才适合改原点；单纯复制或读取不应悄悄改动它。