gozxing解码失败主因是图像未转灰度或宽高传反；须用image.Gray预处理并调NewLuminanceSource(data, width, height)；中文乱码需用GBK解码RawBytes()；小图应先放大再灰度化。
gozxing 解码失败返回 nil 或 panic 怎么办
常见现象是调用 Decode 后结果为 nil，或者直接 panic 报 index out of range。根本原因不是图片格式问题，而是 gozxing 默认只支持灰度图像（LuminanceSource），而 image.Decode 读出来的通常是 RGBA 或 YCbCr。
实操建议：
- 必须先将原始图像转换为灰度图：用
golang.org/x/image/draw+image.Gray构造目标缓冲区，再用draw.Draw渲染 - 别直接传
*jpeg.Image给gozxing.NewRGBSource—— 它实际要求 RGB 数据按[R,G,B,R,G,B,...]平铺，而标准 image 接口不保证内存布局 - 推荐走
gozxing.NewLuminanceSource路线，传入Gray.Pix和宽高，这是最稳定路径
gozxing.NewLuminanceSource 参数顺序容易搞反
这个构造函数签名是 NewLuminanceSource(data []byte, width, height int)，但很多人把 width 和 height 传反，导致解码出错或静默失败（比如识别成乱码、空字符串）。
关键点：
立即学习“go语言免费学习笔记（深入）”；
-
data必须是单通道灰度值切片，每个值范围 0–255 -
width是图像宽度（列数），height是高度（行数）—— 和image.Bounds().Dx()/Dy()一致 - 如果图像本身是横向长条，但传了
height > width，zxing 内部会按错误行列重组像素，二维码定位就失效
中文内容解码乱码或报 UnsupportedEncodingException
gozxing 默认用 UTF-8 解码，但某些生成器（尤其是老旧工具或国产 SDK）可能用了 GBK/GB2312 编码写入 QR 码。此时 decode 出来的是原始字节流，直接转 string 就是乱码，而 gozxing 不自动探测编码。
应对方式：
- 先尝试用
result.Text()获取原始字节：result.RawBytes() - 若怀疑是 GBK，用
golang.org/x/text/encoding/charset中的GBK.NewDecoder().Bytes()转换 - 不要依赖
result.String()—— 它只是对RawBytes()做了 utf8.ToString，不解决编码问题
小尺寸或低质量二维码识别率低怎么办
gozxing 对图像质量敏感，尤其在 100×100 像素以下、边缘模糊、对比度低、有压缩噪点时，常返回 NotFoundException。
可做的预处理：
- 用
golang.org/x/image/draw放大图像（如双线性插值 ×2），再转灰度——比直接增强对比度更有效 - 避免用
image/jpeg原图直解：JPEG 有块效应，优先转 PNG 或用draw.ApproxBiLinear重采样 - 不建议手动二值化（如 Otsu）：zxing 内部已有自适应阈值逻辑，过早二值化反而破坏定位图案
真正卡住的地方往往不在解码逻辑本身，而在图像数据进到 LuminanceSource 前那几步——像素没对齐、宽高传反、编码假设错误，这些细节一错，后面全白忙。
