直接选 qrcode（github.com/skip2/go-qrcode），它更轻、无依赖、api 简单且默认支持 utf-8 中文；go-qrcode 无中文兼容，易乱码或 panic。
二维码生成用 qrcode 库还是 go-qrcode？
直接选 qrcode（github.com/skip2/go-qrcode），它更轻、无依赖、API 简单，且默认支持 UTF-8 中文。而 go-qrcode 依赖 image 包但没做中文兼容处理，学生姓名带中文时容易生成乱码或 panic。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
qrcode.Encode生成字节切片，别直接写文件——后续要嵌入 HTTP 响应或存数据库时更灵活 - 尺寸参数传
256而非256x256：该函数只接受整数像素宽高，传字符串会编译报错cannot use "256x256" (type string) as type int - 容错等级选
qrcode.Medium：学生考勤场景不需要最高容错（High），Medium 已足够应对打印模糊或轻微折角
HTTP 接口返回二维码图片时 Content-Type 总是错
常见错误是写成 w.Header().Set("Content-Type", "image/png") 却忘了写响应体，或者用 fmt.Fprintf 输出二进制数据——这会把 PNG 的 0x00 字节转成 UTF-8 替换符，浏览器显示空白或损坏。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 必须用
w.Write直接写[]byte，例如：w.Write(qrBytes) - Content-Type 必须精确匹配生成格式：
qrcode.Encode默认输出 PNG，所以设为"image/png"；若改用qrcode.EncodeToWriter写 JPEG，则要配"image/jpeg" - 别在 handler 里调
log.Println打印qrBytes——日志会截断二进制，还可能卡住响应流
学生 ID 和姓名拼接进二维码内容，URL 编码漏了
如果直接拼 "id=123&name=张三" 进二维码，扫码后浏览器打开会因中文和特殊字符（如 &、=）解析失败，甚至跳转到错误地址。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
url.QueryEscape包裹每个值："id=" + url.QueryEscape(id) + "&name=" + url.QueryEscape(name) - 避免用
fmt.Sprintf拼整个 query 字符串再整体 escape——这样会把&和=也编码，导致后端无法解析 - 如果二维码内容只是纯文本（比如只放学号），就不用 URL 编码，但务必确认扫码设备能正确识别 UTF-8 字节流
并发生成大量二维码时内存暴涨甚至 OOM
qrcode.Encode 每次都新建图像对象，不复用 buffer。100 个请求并发，每个生成 256×256 PNG，瞬间分配近 10MB 内存，没及时 GC 就容易触发调度延迟或 OOM。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 加一层简单缓存：用
map[string][]byte存已生成的二维码字节，key 用id + "_" + name的 SHA256（避免 key 过长或含特殊字符） - 不要用
sync.Map初期就上——小项目用sync.RWMutex配普通 map 更清晰、更易调试 - 生成前检查缓存命中，命中则直接
w.Write；未命中才调qrcode.Encode，生成后存入缓存
最常被忽略的是缓存 key 的构造方式：用原始字符串当 key 会导致大小写敏感、空格差异、URL 编码不一致等问题，实际扫出来的结果对不上。
