Java 二維碼生成庫深度對比：ZXing vs QRGen vs Swetake vs Barcode4j 選型指南

四大主流庫全維度對比

代碼風格直觀對比

ZXing (標準、可控)

Map hints = Map.of(
    EncodeHintType.ERROR_CORRECTION, ErrorCorrectionLevel.M,
    EncodeHintType.CHARACTER_SET, "UTF-8",
    EncodeHintType.MARGIN, 2
);
BitMatrix matrix = new MultiFormatWriter()
    .encode("Hello 世界", BarcodeFormat.QR_CODE, 300, 300, hints);
BufferedImage image = MatrixToImageWriter.toBufferedImage(matrix);
ImageIO.write(image, "PNG", new File("zxing.png"));

QRGen (一行代碼)

QRCode.from("Hello 世界")
      .withSize(300, 300)
      .withErrorCorrection(ErrorCorrectionLevel.M)
      .withCharset("UTF-8")
      .to(ImageType.PNG)
      .writeTo(new File("qrgen.png"));

// 帶 Logo
QRCode.from("Hello 世界")
      .withLogo(new File("logo.png")) // 內建 Logo 支持
      .to(ImageType.PNG)
      .writeTo(new File("qrgen-logo.png"));

Swetake (傳統、教學常見)

Qrcode qrcode = new Qrcode();
qrcode.setQrcodeErrorCorrect('M'); // L/M/Q/H
qrcode.setQrcodeEncodeMode('B');   // N/A/B/K
qrcode.setQrcodeVersion(7);        // 1-40 (自動版本設 0)
byte[] data = "Hello 世界".getBytes("GB2312"); // 注意編碼
boolean[][] matrix = qrcode.calQrcode(data);

BufferedImage img = new BufferedImage(140, 140, BufferedImage.TYPE_INT_RGB);
Graphics2D g = img.createGraphics();
g.setColor(Color.WHITE);
g.fillRect(0, 0, 140, 140);
g.setColor(Color.BLACK);
for (int i = 0; i < matrix.length; i++) {
    for (int j = 0; j < matrix.length; j++) {
        if (matrix[j][i]) g.fillRect(j * 3 + 2, i * 3 + 2, 3, 3);
    }
}
ImageIO.write(img, "PNG", new File("swetake.png"));

Barcode4j (矢量輸出、報表集成)

QRCodeBean bean = new QRCodeBean();
bean.setModuleWidth(UnitConv.in2mm(1.0f / 72)); // 模塊寬度
bean.setMsg("Hello 世界");
bean.setErrorCorrectionLevel(ErrorCorrectionLevel.M);

CanvasProvider canvas = new SVGCanvasProvider(
    false, 0, new FileOutputStream("barcode4j.svg"));
QRCodeLogicImpl logic = new QRCodeLogicImpl();
logic.generateBarcode(canvas, bean);
canvas.finish();

選型決策樹

需要解析/掃描？ ──Yes──► ZXing (唯一完整支持生成+解析)
否
  需要 SVG/EPS/PDF 矢量輸出/專業打印？ ──Yes──► Barcode4j
  否
    僅生成 QR Code、極簡依賴、不想寫 Hint？ ──Yes──► QRGen
    否
      純 QR Code、舊項目、無法引入 ZXing？ ──Yes──► Swetake (不推薦新項目)
      否
        默認選 ZXing (功能最全、性能最好、社區最活躍)

生產級建議：統一封裝 ZXing，屏蔽細節

參考文章 236984 的 QrCodeGenerator / QrCodeParser 封裝，提供：

• 統一錯誤碼/異常體系
• 默認合理 Hints (UTF-8, M級, Margin=2)
• Logo 嵌入、多角度解析、Base64/流/文件多輸出
• Spring Boot Starter 自動配置

避坑指南

總結

**新項目無腦選 ZXing** —— 功能最全、性能最強、社區最活、解析生成一站式。QRGen 適合快速寫 Demo/測試；Barcode4j 專攻矢量輸出/報表打印；Swetake 已進入博物館，**嚴禁新項目引入**。封裝統一工具類，業務層零感知切換實現，才是架構師的正確姿勢。