直接用qrcode.encode生成的图片常被微信/支付宝拒扫，是因为未设置content-type: image/png、未禁用png的gamma校正、未压缩alpha通道，导致扫码引擎识别率骤降；需用png.encode配合自定义encoder.gamma=nil及color.nrgba模式，并显式设置响应头。

为什么直接用 qrcode.Encode 生成的图片常被微信/支付宝拒扫

不是编码失败，而是默认输出的 PNG 缺少关键元数据：没有设置 Content-Type: image/png、未禁用 PNG 的 gamma 校正、未压缩透明通道（Alpha），导致部分扫码引擎识别率骤降。微信客户端对 PNG 的 ICC profile 和 gAMA chunk 敏感，一并写入就会触发兼容性降级。

• 务必在调用 qrcode.Encode 后，用 png.Encode 手动写入，并传入自定义 png.Encoder
• 禁用 gamma：设置 encoder.Gamma = nil
• 强制使用 color.NRGBA 模式，避免 alpha 混合干扰二值化识别
• HTTP 响应头必须显式设为 Content-Type: image/png，不能依赖 http.DetectContentType

如何把用户 ID + 渠道参数安全拼进二维码内容

业务推广码本质是带参跳转链接，但直接拼接原始 URL 容易触发 XSS 或重定向劫持。Go-qrcode 不处理内容安全，这一步必须由你控制。

Golang Naming

Go（Golang）命名规范 — 包括包、构造函数、结构体、接口、常量、枚举、错误、布尔值、接收器、getter/setter、函数等。

下载

• 用 url.URL 构建目标地址，再调用 u.Query().Set("uid", uid) 和 u.Query().Set("channel", ch)
• 绝对不要用 fmt.Sprintf 拼接 query string —— 中文、特殊字符会破坏 URL 结构
• 若需防篡改，应在服务端生成时对参数做签名（如 HMAC-SHA256），二维码内容为 https://yoursite.com/go?sig=xxx&uid=123&channel=wechat
• 签名验证必须放在跳转落地页，而非二维码生成环节

并发生成推广码时内存暴涨，怎么压住峰值

qrcode.Encode 返回的是 *image.RGBA，底层是大块连续内存。高并发下不复用缓冲区，GC 来不及回收，容易 OOM。

• 提前预估尺寸：推广码一般用 size=300 足够，别用 512 或更大 —— 分辨率翻倍，内存占用翻四倍
• 复用 bytes.Buffer：每个 goroutine 分配独立 buffer，但避免全局共用（非线程安全）
• 用 sync.Pool 缓存 *image.RGBA 实例，尺寸固定时效果显著（注意清空像素数据）
• 生成后立即调用 img.Pix = nil，加速 GC 回收

生成带 Logo 的推广码，为什么 Logo 总糊成一团

Logo 叠加不是简单 paste，核心矛盾在于：二维码本身是二值图像（黑/白），而 Logo 是彩色渐变图。直接覆盖会导致定位点（Finder Pattern）边缘失真，扫码失败。

• 先用 qrcode.WithQRCode 生成纯码，再用 draw.DrawMask 将 Logo 作为 mask 叠加到中心区域
• Logo 尺寸严格限制在总宽的 20%~25%，超出会破坏三个定位角的几何结构
• 务必对 Logo 图像做二值化预处理（或转为灰度+阈值），避免半透明像素干扰纠错模块
• 测试时用「微信扫一扫」+「支付宝扫一扫」双验，二者解码策略不同，单测容易漏问题

实际线上跑起来，最常卡在 PNG 元数据和并发内存上。参数签名和 Logo 处理属于业务强相关，没法靠库自动兜底，得自己盯住。

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！