Go YCbCr.COffset 怎样定位下采样后的色度分量

处理 JPEG、视频帧或颜色采样数据时，常见的错位并不是切片越界，而是把亮度平面的偏移公式误用到了色度平面。Go 的 image.YCbCr 每个像素都有一个 Y 样本，但 Cb、Cr 样本可能覆盖多个像素。定位色度分量时，应直接调用 COffset(x, y)，再用返回值访问 Cb 和 Cr。

记住一条规则：YOffset 只回答 Y 平面的下标，COffset 才回答当前像素对应的 Cb/Cr 下标；下采样比例、Rect.Min 和 CStride 都由它统一处理。

本文围绕 Go 标准库 image 包中的 YCbCr.COffset 展开，重点看 4:4:4、4:2:2 和 4:2:0 三种布局，不把讨论扩展到颜色转换公式或 JPEG 编码器内部实现。

先分清 Y 平面和 Cb/Cr 平面

YCbCr 结构体分别保存 Y、Cb、Cr 三个字节切片。YStride 是亮度平面相邻行的步长，CStride 是色度样本行之间的步长。4:4:4 中每个像素都有独立色度样本；4:2:2 只在水平方向降采样；4:2:0 则在水平和垂直方向都降采样。

因此，同一组色度值可能被多个相邻像素复用。若直接按 (y-Rect.Min.Y)*CStride+(x-Rect.Min.X) 计算，水平下采样会让列下标偏大，垂直下采样还会让行下标错位。

COffset 怎样处理下采样比例

官方实现把采样规则集中在 COffset 中。可以把它理解成“先把坐标换算到色度网格，再按色度行步长计算线性下标”。典型公式如下：

每种比例得到的色度坐标还要乘上对应行的 CStride。这里不要自行假设 CStride == YStride/2 永远成立；标准库文档给出的是典型关系，实际结构体可能来自子图或自定义缓冲区，读取时应以字段本身为准。

把 Rect.Min 和 CStride 带入读取代码

下面的例子先构造一个 4:2:0 图像，再读取一个像素对应的色度样本。代码只依赖公开字段，便于在处理解码结果或自建缓冲区时复用。

package main

import (
    "fmt"
    "image"
)

func main() {
    // 用非零起点模拟子图，提醒读取逻辑不要默认 Rect 从 (0,0) 开始。
    rect := image.Rect(10, 20, 14, 24)
    ycbcr := image.NewYCbCr(rect, image.YCbCrSubsampleRatio420)

    // 选择一个位于边界内的亮度像素；COffset 会换算到色度网格。
    x, y := 13, 22
    ci := ycbcr.COffset(x, y)
    if ci = len(ycbcr.Cb) || ci >= len(ycbcr.Cr) {
        // Cb 和 Cr 共用同一个色度下标，两个切片都必须能访问。
        panic("YCbCr 色度下标越界")
    }

    fmt.Printf("COffset(%d,%d)=%d, Cb=%d, Cr=%d\\n",
        x, y, ci, ycbcr.Cb[ci], ycbcr.Cr[ci])
}

这段代码的关键不是打印结果，而是索引来源：COffset 同时考虑了采样比例、矩形起点和 CStride。如果只需要颜色对象，也可以调用 ycbcr.YCbCrAt(x, y)，让标准库继续完成 Y、Cb、Cr 的组合。

排查错位时看这四个边界

1. 先看比例：确认 SubsampleRatio 是否为 4:4:4、4:2:2 或 4:2:0，不要凭文件扩展名猜。
2. 再看起点：当 Rect.Min 不是零时，坐标换算必须保留 Rect.Min.X/2 或 Rect.Min.Y/2 的对应项。
3. 再看步长：CStride 是色度行跨度，不等于色度切片长度，也不能用 YStride 替代。
4. 最后看两个平面：Cb[ci] 与 Cr[ci] 使用同一个 ci，边界判断要同时覆盖两个切片。

如果只是调用 At 或 YCbCrAt，通常不需要手写索引；只有在做色度统计、平面复制、滤镜或零拷贝处理时，才有必要直接使用 COffset。

常见疑问

4:2:2 中相邻两列一定共享 Cb/Cr 吗？在标准采样坐标下，水平方向按两个亮度像素共享一个色度样本；实际边界仍应交给 COffset 计算。

能不能把 Cb 和 Cr 拼成一个切片处理？不建议这样做。Go 的结构体把它们作为两个独立平面保存，COffset 返回的是各自平面内的下标，不是交错存储地址。

总结来说，正确路径是“确定采样比例 → 调用 COffset → 用返回下标访问 Cb/Cr → 同时检查切片边界”。把这条路径固定下来，就能避免因下采样和非零图像边界造成的颜色错位。