Golang生成二维码：go-qrcode库使用教程

“纵有疾风来，人生不言弃”，这句话送给正在学习Golang的朋友们，也希望在阅读本文《Golang生成二维码教程：go-qrcode库实战指南》后，能够真的帮助到大家。我也会在后续的文章中，陆续更新Golang相关的技术文章，有好的建议欢迎大家在评论留言，非常感谢！

使用 go-qrcode 生成二维码需先安装库，再调用方法生成 PNG 文件或返回 HTTP 流。1. 安装命令为 go get github.com/skip2/go-qrcode；2. 生成文件示例代码为 qrcode.WriteFile("https://example.com", qrcode.Medium, 256, "qrcode.png")；3. 容错等级包括 L、M、Q、H，推荐使用 Medium；4. 图像尺寸建议 200 像素以上以确保可识别性；5. 可结合其他图像库自定义样式如加颜色或 Logo；6. Web 中可通过 http.ResponseWriter 返回二维码流实现动态生成。

生成二维码在现代开发中很常见，比如用作链接、支付码或者信息传递。Golang 有个非常好用的第三方库叫 go-qrcode，可以快速实现二维码图像的生成。下面我们就来看看怎么用它来生成二维码。

安装 go-qrcode

首先你需要确保你的 Go 环境已经配置好。然后通过以下命令安装 go-qrcode：

go get github.com/skip2/go-qrcode

这个命令会自动下载并安装该库到你的项目中。

最简单的使用方式：生成 PNG 文件

如果你只是想把一段文本或链接转成二维码图片，可以用如下代码直接生成 PNG 文件：

package main

import (
    "log"
    "github.com/skip2/go-qrcode"
)

func main() {
    // 第一个参数是内容，第二个是大小（L, M, Q, H）
    err := qrcode.WriteFile("https://example.com", qrcode.Medium, 256, "qrcode.png")
    if err != nil {
        log.Fatal(err)
    }
}

运行之后，当前目录下就会生成一个名为 qrcode.png 的二维码图片。你可以用微信或支付宝扫一扫试试看。

这里要注意几个点：

• 第二个参数是容错等级，有四个选项：L（7%）、M（15%）、Q（25%）、H（30%），默认推荐用 qrcode.Medium。
• 第三个参数是图像尺寸，单位是像素，建议至少设为 200 以上，否则可能扫不出来。

自定义样式？加颜色或Logo？

虽然 go-qrcode 默认只支持黑白 PNG 图片，但你可以结合其他图像处理库（如 image/png, image/color）来修改颜色或者叠加 Logo。

举个例子，假设你想生成一个红色背景的二维码，可以这样做：

qrCode, err := qrcode.Encode("https://example.com", qrcode.Medium, 256)
if err != nil {
    log.Fatal(err)
}

// 打开文件并保存，这部分略去，你可以用 os 包写入文件

如果你想加入 Logo 或者彩色样式，可能需要借助像 github.com/golang/freetype 或 github.com/disintegration/imaging 这类图像处理库进行二次加工。

不过需要注意的是，这些操作就不属于 go-qrcode 的原生功能了，需要自己额外处理。

Web 中返回二维码流

有时候你不想生成文件，而是希望在 HTTP 接口中直接返回二维码图像流。这时候你可以这样写：

func generateQR(w http.ResponseWriter, r *http.Request) {
    content := "https://example.com"
    qrCode, _ := qrcode.Encode(content, qrcode.Medium, 256)
    w.Header().Set("Content-Type", "image/png")
    w.Write(qrCode)
}

然后注册路由，访问时就可以直接看到二维码图片。

这种方式适合做动态生成二维码的服务接口，比如根据用户输入的内容实时生成。

基本上就这些。用 go-qrcode 做二维码生成不算复杂，但有些细节容易忽略，比如尺寸太小导致无法识别、容错等级影响可读性等。只要注意这些点，就能轻松搞定大部分需求。

本篇关于《Golang生成二维码：go-qrcode库使用教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！