根本原因是logo尺寸过大或未按比例缩放导致压垮纠错区域；必须用qrcode.withsize(512)设最小尺寸、logo≤二维码25%、启用qrcode.medium纠错等级，并用image/draw双线性缩放。
Go-qrcode 生成带 Logo 的二维码为什么总是模糊或变形？
根本原因是 qrcode.WriteToFile 默认使用 PNG 编码，但未设置足够高的 DPI 或画布尺寸，导致缩放后失真；加上 Logo 覆盖时若未按比例缩放、未预留边距，会直接压垮纠错区域。
- 务必用
qrcode.WithSize(512)显式指定最小输出尺寸（至少 400px），避免默认 256px 在高清屏下糊成一片 - Logo 宽高必须 ≤ 二维码尺寸的 25%，且需用
image.Resize（来自golang.org/x/image/draw）做双线性缩放，不能直接Draw填充 - 必须启用纠错等级：传入
qrcode.Low/qrcode.Medium（推荐qrcode.Medium），否则加 Logo 后扫码率断崖下跌
如何让 Go-qrcode 输出透明背景 PNG 用于前端叠加？
go-qrcode 底层用 image/png，而 PNG 支持 Alpha 通道——但默认生成的是 color.RGBAModel 背景，不是透明。关键在手动构造 RGBA 图像并清空 Alpha 通道。
- 不要用
qrcode.WriteToFile，改用qrcode.Encode得到*image.NRGBA - 创建新
*image.NRGBA画布，尺寸同二维码，调用draw.Draw把编码结果贴上去 - 遍历像素点，对非黑色区域（即二维码模块）保留 Alpha=255，其余设为 Alpha=0 —— 注意：不能简单设为纯白+Alpha，扫码器会误判背景噪声
- 写入时用
png.Encode(w, img)，w可以是bytes.Buffer或 HTTP response body
并发生成大量业务码时 CPU 占用飙升怎么办？
go-qrcode 是纯 CPU 计算型库，无 I/O 等待，高并发下容易打满单核。它本身不提供池化或缓存，必须自行控制资源边界。
- 禁止在 HTTP handler 里直接调用
qrcode.Encode—— 每次请求都重算，QPS 上百就卡死 - 对相同内容（如固定跳转链接 + 固定 Logo）做 LRU 缓存，key 用
sha256(content + logoHash)，value 是[]byte（PNG 数据） - 限制并发数：用
semaphore.NewWeighted(4)（来自golang.org/x/sync/semaphore），每生成一个码 acquire(1)，避免瞬间 100 个 goroutine 全挤在 QR 编码上 - 预热常用码：服务启动时用 goroutine 预生成高频业务码（如首页引流码），存内存 map，首请求免计算
HTTP 接口返回二维码时 Content-Type 总是错？
常见错误是写完 PNG 数据后忘记设 header，或用了 text/plain 导致浏览器下载乱码文件，或用 image/jpeg 强转 PNG 导致损坏。
- 必须在 Write 前调用
w.Header().Set("Content-Type", "image/png") - 如果返回 base64 字符串（供前端
src="data:image/png;base64,..."），Content-Type 应设为application/json，且 JSON 字段名明确叫qr_data，别叫data这种泛称 - 严禁用
io.Copy直接转发文件流却不设 header —— Nginx 或 CDN 可能覆盖掉你设的类型
qrcode.Medium，微信扫出来就是“识别失败”。这不是库的问题，是 QR 标准本身的容错设计决定的。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
