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

想知道如何使用 Golang 快速生成二维码吗？本文为你提供一份详尽的 go-qrcode 库实战指南，助你轻松掌握二维码生成技巧。首先，通过 `go get github.com/skip2/go-qrcode` 命令安装库。然后，只需一行代码即可生成 PNG 文件，例如：`qrcode.WriteFile("https://example.com", qrcode.Medium, 256, "qrcode.png")`。文章还详细介绍了容错等级的选择（推荐 Medium）和图像尺寸的设置（建议 200 像素以上）。此外，你还可以结合其他图像库自定义二维码样式，添加颜色或 Logo。更进一步，本文还讲解了如何在 Web 应用中通过 `http.ResponseWriter` 返回二维码流，实现动态生成。掌握这些技巧，你就能在 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相关知识，快来关注吧！