您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> Java 相關知識

Java 使用 ZXing 生成帶文字的二維碼完整教程

編輯：Java 相關知識

前言

二維碼已成為現代應用中不可或缺的資訊傳遞方式。本文將詳細介紹如何使用 Google 的 ZXing 庫在 Java 中生成帶有自定義文字的二維碼圖片，並提供完整的程式碼範例供參考學習。

環境準備：Maven 依賴

首先在專案的 pom.xml 中引入 ZXing 核心庫：

<dependency>
    <groupId>com.google.zxing</groupId>
    <artifactId>core</artifactId>
    <version>3.2.1</version>
</dependency>

核心步驟一：生成基本二維碼圖片

建立工具類 QRCodeUtil，封裝二維碼生成邏輯：

import com.google.zxing.*;
import com.google.zxing.common.BitMatrix;
import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.File;
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;

public class QRCodeUtil {
    private static final int BLACK = 0xFF000000;
    private static final int WHITE = 0xFFFFFFFF;
    private static final int WIDTH = 300;
    private static final int HEIGHT = 300;

    /** 將 BitMatrix 轉換為 BufferedImage */
    public static BufferedImage toBufferedImage(BitMatrix matrix) {
        int width = matrix.getWidth();
        int height = matrix.getHeight();
        BufferedImage image = new BufferedImage(width, height, BufferedImage.TYPE_INT_RGB);
        for (int x = 0; x < width; x++) {
            for (int y = 0; y < height; y++) {
                image.setRGB(x, y, matrix.get(x, y) ? BLACK : WHITE);
            }
        }
        return image;
    }

    /** 生成二維碼並寫入文件 */
    public static void writeToFile(String content, String format, File file) throws Exception {
        MultiFormatWriter writer = new MultiFormatWriter();
        Map<EncodeHintType, Object> hints = new HashMap<>();
        hints.put(EncodeHintType.CHARACTER_SET, "UTF-8");      // 防止中文亂碼
        hints.put(EncodeHintType.MARGIN, 1);                    // 設置邊距
        hints.put(EncodeHintType.ERROR_CORRECTION, ErrorCorrectionLevel.H); // 高容錯率

        BitMatrix bitMatrix = writer.encode(content, BarcodeFormat.QR_CODE, WIDTH, HEIGHT, hints);
        BufferedImage image = toBufferedImage(bitMatrix);
        if (!ImageIO.write(image, format, file)) {
            throw new IOException("無法寫入圖片文件: " + file);
        }
    }
}

核心步驟二：在二維碼中央添加文字

使用 Java 2D 繪圖 API 將文字繪製到已生成的二維碼圖片上：

import java.awt.*;
import java.awt.image.BufferedImage;
import java.io.File;
import java.io.FileOutputStream;
import javax.imageio.ImageIO;

/** 給二維碼圖片添加文字水印 */
public static void pressText(String pressText, File qrFile, int fontStyle, Color color, int fontSize) throws Exception {
    Image src = ImageIO.read(qrFile);
    int imageW = src.getWidth(null);
    int imageH = src.getHeight(null);
    BufferedImage image = new BufferedImage(imageW, imageH, BufferedImage.TYPE_INT_RGB);
    Graphics g = image.createGraphics();
    g.drawImage(src, 0, 0, imageW, imageH, null);

    g.setColor(color);
    Font font = new Font("宋體", fontStyle, fontSize);
    FontMetrics metrics = g.getFontMetrics(font);
    // 計算文字居中座標
    int startX = (WIDTH - metrics.stringWidth(pressText)) / 2;
    int startY = HEIGHT / 2 + metrics.getAscent() / 2; // 微調垂直居中

    g.setFont(font);
    g.drawString(pressText, startX, startY);
    g.dispose();

    try (FileOutputStream out = new FileOutputStream(qrFile)) {
        ImageIO.write(image, "JPEG", out);
    }
    System.out.println("文字添加成功");
}

完整測試範例

public static void main(String[] args) throws Exception {
    File qrFile = new File("/tmp/qrcode_with_text.jpg");
    // 1. 生成基本二維碼
    QRCodeUtil.writeToFile("https://www.example.com", "jpg", qrFile);
    // 2. 添加中央文字
    QRCodeUtil.pressText("掃碼訪問", qrFile, Font.BOLD, Color.RED, 24);
}