使用Go可轻松实现二维码生成工具,先通过github.com/skip2/go-qrcode生成基础二维码,再结合imaging库自定义颜色与添加Logo,并可通过HTTP服务提供Web接口,支持缓存、多格式输出和纠错等级配置,适用于支付、登录等场景。

二维码生成在现代应用中非常常见,比如支付、登录、分享等场景。Golang 由于其高性能和简洁语法,非常适合用来构建这类工具。本文将带你用 Go 实现一个轻量级的二维码生成工具,并介绍常用的图片处理库实战技巧。
选择合适的二维码生成库
Go 社区有几个成熟的二维码生成库,其中最常用的是 github.com/skip2/go-qrcode。它使用简单,无需依赖外部图像库,直接生成 PNG 格式的二维码数据。
安装方式:
go get github.com/skip2/go-qrcode基本使用示例:
立即学习“go语言免费学习笔记(深入)”;
qrCode, err := qrcode.Encode("https://example.com", qrcode.Medium, 256)if err != nil {
// 处理错误
}
// qrCode 是 []byte,可以直接写入文件或返回 HTTP 响应
自定义二维码样式(颜色、Logo)
默认的 go-qrcode 不支持颜色或嵌入 Logo,但我们可以结合图像处理库进行二次加工。推荐使用 github.com/gographics/imagick 或更轻量的 image 标准库 + github.com/disintegration/imaging。
以下是如何修改二维码颜色并添加 Logo 的思路:
- 先用 go-qrcode 生成黑白二维码
- 解码为 image.Image 对象
- 遍历像素,将黑色点替换为目标颜色(如深蓝)
- 加载 Logo 图片,缩放后叠加到二维码中心
- 使用 imaging 库裁剪、合成并保存最终图片
代码片段示例(使用 imaging):
srcImage, _ := png.Decode(bytes.NewReader(qrCodeData))img := imaging.Clone(srcImage)
// 替换颜色(需手动操作像素)
// 添加 logo
logo, _ := imaging.Open("logo.png")
logo = imaging.Resize(logo, 80, 80, imaging.Lanczos)
img = imaging.Overlay(img, logo, image.Pt(138, 138), 1.0)
提供 Web 接口快速调用
可以封装成一个简单的 HTTP 服务,接收文本内容,返回二维码图片。
示例路由:
http.HandleFunc("/qrcode", func(w http.ResponseWriter, r *http.Request) {text := r.URL.Query().Get("text")
if text == "" {
text = "https://example.com"
}
qrCode, err := qrcode.Encode(text, qrcode.Highest, 512)
if err != nil {
http.Error(w, "生成失败", 500)
return
}
w.Header().Set("Content-Type", "image/png")
w.Write(qrCode)
})
启动后访问:/qrcode?text=hello 即可看到二维码。
优化与扩展建议
实际项目中还可以加入以下功能:
- 缓存机制:对相同内容的二维码做内存或文件缓存,避免重复生成
- 支持多种格式输出:如 SVG、JPEG
- 配置纠错等级:L/M/Q/H,越高容错越强
- 设置边距、背景透明度等细节参数
- 集成到 CLI 工具,支持命令行生成本地文件
基本上就这些。用 Go 写二维码工具不复杂,但组合几个库就能做出实用的功能。关键是理解图像处理流程:生成 → 解码 → 修改 → 合成 → 输出。掌握这套模式后,你也可以做条形码、海报生成等更多图像类工具。










