qrcode.Encode 返回 *image.RGBA 对象而非 PNG 字节流需用 png.Encode 编码忽略 error、尺寸非法、纠错等级误用常量、中文兼容性、URL 编码未解码、Content-Type 未前置设置、HTTPS 混合内容及颜色自定义需手动像素操作。qrcode.Encode 返回的不是 PNG是 *image.RGBA很多人一上来就 qrcode.Encode拿到返回值直接 fmt.Println 或塞进 w.Write结果看到内存地址或一堆乱码——因为它的返回值是 Go 的图像对象 *image.RGBA不是字节流更不是 PNG 文件。必须用 png.Encode 手动编码先 os.Create(q.png) 或传 http.ResponseWriter再 png.Encode(f, img)忽略 error 是高频崩溃点比如路径含中文、父目录不存在、文件正被看图软件占用都会导致 png.Encode 失败但无提示尺寸参数是像素总数如 256不是“小中大”传 0 或负数会 panic传 16 基本扫不出来纠错等级必须用常量qrcode.Low/qrcode.Medium别传数字 1 或字符串 medium否则行为异常且不报错中文内容扫码失败不是库的问题是编码和兼容性问题go-qrcode 本身只做 Base32 编码点阵绘制对 UTF-8 字符串完全支持。但微信旧版、部分终端扫码器对非 ASCII 内容解析弱这不是 bug是现实兼容性边界。前端传参若经 URL 编码如 texthttps%3A%2F%2Fexample.com后端必须先 url.QueryUnescape否则生成的是带 %3A 的错误链接纯中文内容建议预处理url.QueryEscape(你好) 再传给 qrcode.Encode提升各平台识别率避免混用全角标点、不可见控制字符如 ​某些扫码器会截断或静默失败校验输入是否合法 UTF-8utf8.Valid([]byte(s))非法字节会触发 qrcode: content contains invalid charactersHTTP API 中生成二维码Content-Type 和顺序不能错浏览器显示乱码、iOS Safari 不加载、微信内嵌页拒绝渲染——90% 是响应头没设对而且必须在任何写操作之前设置。 Evoker 一站式AI创作平台