qrcode库是go中生成png二维码最简路径，无cgo依赖、单文件可执行；需用png.encode将*image.rgba写入文件，尺寸参数为模块边长，颜色自定义须逐像素重绘。
用 qrcode 库生成 PNG 二维码最简路径
Go 生态里最轻量、无 CGO 依赖、直接输出 PNG 的库是 qrcode（github.com/skip2/go-qrcode）。它不依赖 ImageMagick 或 cgo，编译后单文件可直接运行，适合 CLI 工具或嵌入式场景。
常见错误是直接调用 qrcode.Encode 后忽略返回的 *image.RGBA，试图用 fmt.Println 打印——结果只看到内存地址。必须显式编码为 PNG 写入文件或响应体。
-
qrcode.Encode("https://example.com", qrcode.Medium, 256)返回*image.RGBA和error，不能直接当字节流用 - 写文件需用
png.Encode：先os.Create("qrcode.png")，再png.Encode(f, img) - 尺寸参数不是像素数而是「模块边长」，256 表示整个二维码图像是 256×256 像素；实际内容区域会略小，四周有 quiet zone（默认 4 模块）
- 容错等级用
qrcode.Low/Medium/Quartile/High，Medium是平衡点，High会让相同内容生成更大矩阵（更多冗余码字），但不提升清晰度
自定义颜色和背景：绕过 qrcode 默认黑白限制
qrcode 原生只输出黑白 RGBA 图像（黑=0x000000ff，白=0xffffffff）。想改颜色？得自己遍历像素点重绘，别试图 patch 库源码——它没留钩子。
典型误操作是把 *image.RGBA 直接丢给 draw.Draw 填充，结果整张图变单色。正确做法是逐像素判断是否为黑点，再映射为目标色。
立即学习“go语言免费学习笔记（深入）”；
- 先用
img.Bounds()获取矩形范围，再双层循环for y := ...; for x := ... - 用
img.RGBAAt(x, y)取像素，对比是否接近黑色：r, g, b, _ := p.RGBA(); if r - 用
img.SetRGBA(x, y, rNew, gNew, bNew, 0xff)覆盖，注意 Go 的color.RGBA是 16 位分量（0–65535），传 0–255 需左移 8 位：uint8(r)*0x100 - 背景色同理：对所有非黑点设为背景色，比“先填背景再画前景”更稳，避免 quiet zone 被漏掉
HTTP 服务中实时生成二维码：避免内存泄漏的关键点
在 Gin/echo 等框架里用 qrcode.Encode 处理请求时，若直接把生成的 *image.RGBA 丢给 png.Encode(w, img)，看似没问题，但容易忽略 image.RGBA 底层的 pix 字段——它是大块 []byte，GC 不会立刻回收，高并发下可能吃光内存。
真实压测中见过 QPS 200 时 RSS 涨到 1.2GB，重启后回落。问题不在库本身，而在没复用图像缓冲区。
- 用
sync.Pool缓存*image.RGBA实例：池对象 New 函数里创建固定尺寸（如 512×512）的 RGBA 图 - 每次 Encode 前从池取，Encode 完写完 PNG 立即
pool.Put(img)，别等函数返回 - 注意
qrcode.Encode内部会重新分配pix，所以即使用了 Pool，也要确保池中对象尺寸 ≥ 请求所需尺寸，否则仍会 alloc - 如果 URL 参数带恶意超长字符串（如 10MB data URI），
qrcode.Encode会卡住或 OOM——务必加长度校验，例如if len(text) > 2048 { http.Error(w, "text too long", http.StatusBadRequest); return }
替代方案对比：github.com/boombuler/barcode 为什么一般不用
这个库支持 QR、Code128 等多种码制，但生成 QR 时默认用 barcode.QRCode，底层调的是 github.com/llgcode/draw2d，依赖浮点运算和路径绘制，生成的图边缘模糊、模块不齐整，且不支持设置容错等级。
更麻烦的是它返回 barcode.Barcode 接口，转 PNG 必须走 barcode.WriteTo，而该方法内部 new 一个 draw2d.Image，尺寸固定为 300×300，无法按需缩放——想输出 1024×1024？只能先画小图再 resize，质量二次损失。
-
qrcode输出的是精确的模块化栅格图，每个“黑块”严格对应一个像素方阵，扫码器兼容性更好 -
barcode的 QR 实现没做 mask pattern 优化（ISO/IEC 18004 要求的 8 种掩模），部分老旧扫码设备扫不出来 - 若项目已用
barcode且只生成条形码，没必要换；但专做二维码，qrcode是更干净的选择
真正难的不是调哪个函数，是理解二维码规范里 quiet zone、mask pattern、redundancy level 这些概念怎么映射到库的参数和输出行为上。参数调错，图能生成，但扫不出来——这种问题不会报错，只会静默失败。
