使用Java生成带Logo的二维码：完整指南与代码实现

编程小白狼

发布于 2025-08-22 09:01:26

27500

代码可运行

文章被收录于专栏：编程小白狼编程小白狼

运行总次数：0

代码可运行

二维码（QR Code）已成为现代生活中不可或缺的一部分，从支付到信息传递，应用广泛。有时我们需要在二维码中加入Logo以增强品牌识别度。本文将详细介绍如何使用Java生成带Logo的二维码。

技术选型

我们将使用以下库来实现这个功能：

ZXing (Zebra Crossing)：一个强大的开源二维码处理库
Java AWT：用于图像处理和Logo叠加

环境准备

在开始之前，确保你的项目中包含了ZXing库。如果使用Maven，在pom.xml中添加：

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

实现步骤

1. 生成基础二维码

首先，我们需要创建一个基础的二维码：

import com.google.zxing.BarcodeFormat;
import com.google.zxing.EncodeHintType;
import com.google.zxing.MultiFormatWriter;
import com.google.zxing.common.BitMatrix;
import com.google.zxing.qrcode.decoder.ErrorCorrectionLevel;

import java.awt.*;
import java.awt.image.BufferedImage;
import java.io.File;
import java.util.HashMap;
import java.util.Map;
import javax.imageio.ImageIO;

public class QRCodeWithLogo {

    public static BufferedImage createQRCode(String content, int width, int height) throws Exception {
        Map<EncodeHintType, Object> hints = new HashMap<>();
        hints.put(EncodeHintType.CHARACTER_SET, "UTF-8");
        // 设置纠错级别为H，最高级别，这样即使部分被遮挡也能识别
        hints.put(EncodeHintType.ERROR_CORRECTION, ErrorCorrectionLevel.H);
        
        BitMatrix bitMatrix = new MultiFormatWriter().encode(
            content, BarcodeFormat.QR_CODE, width, height, hints);
        
        BufferedImage qrImage = new BufferedImage(width, height, BufferedImage.TYPE_INT_RGB);
        for (int x = 0; x < width; x++) {
            for (int y = 0; y < height; y++) {
                qrImage.setRGB(x, y, bitMatrix.get(x, y) ? Color.BLACK.getRGB() : Color.WHITE.getRGB());
            }
        }
        return qrImage;
    }
}

2. 添加Logo到二维码

接下来，我们将Logo添加到二维码中心：

public class QRCodeWithLogo {
    // 上面的createQRCode方法...
    
    public static BufferedImage addLogoToQRCode(BufferedImage qrImage, String logoPath) throws Exception {
        Graphics2D graphics = qrImage.createGraphics();
        
        // 读取Logo图像
        BufferedImage logoImage = ImageIO.read(new File(logoPath));
        
        // 计算Logo尺寸（二维码大小的1/5）
        int logoWidth = qrImage.getWidth() / 5;
        int logoHeight = qrImage.getHeight() / 5;
        
        // 计算Logo位置（居中）
        int x = (qrImage.getWidth() - logoWidth) / 2;
        int y = (qrImage.getHeight() - logoHeight) / 2;
        
        // 绘制Logo
        graphics.drawImage(logoImage, x, y, logoWidth, logoHeight, null);
        graphics.dispose();
        
        return qrImage;
    }
}

3. 完整示例代码

下面是完整的可运行示例：

public class QRCodeWithLogo {
    
    public static void main(String[] args) {
        try {
            // 生成基础二维码
            BufferedImage qrImage = createQRCode("https://www.example.com", 300, 300);
            
            // 添加Logo
            BufferedImage finalImage = addLogoToQRCode(qrImage, "path/to/logo.png");
            
            // 保存结果
            ImageIO.write(finalImage, "PNG", new File("qrcode_with_logo.png"));
            
            System.out.println("带Logo的二维码已生成成功！");
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
    
    public static BufferedImage createQRCode(String content, int width, int height) throws Exception {
        // 实现同上
    }
    
    public static BufferedImage addLogoToQRCode(BufferedImage qrImage, String logoPath) throws Exception {
        // 实现同上
    }
}

进阶优化

1. Logo圆角处理

为了使Logo更加美观，我们可以添加圆角效果：

public static BufferedImage makeRoundedCorner(BufferedImage image, int cornerRadius) {
    int w = image.getWidth();
    int h = image.getHeight();
    BufferedImage output = new BufferedImage(w, h, BufferedImage.TYPE_INT_ARGB);

    Graphics2D g2 = output.createGraphics();
    g2.setComposite(AlphaComposite.Src);
    g2.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON);
    g2.setColor(Color.WHITE);
    g2.fill(new RoundRectangle2D.Float(0, 0, w, h, cornerRadius, cornerRadius));
    g2.setComposite(AlphaComposite.SrcAtop);
    g2.drawImage(image, 0, 0, null);
    g2.dispose();
    
    return output;
}

2. Logo白边处理

为了防止Logo颜色与二维码颜色太接近导致识别困难，可以添加白色边框：

public static BufferedImage addLogoWithBorder(BufferedImage qrImage, String logoPath) throws Exception {
    Graphics2D graphics = qrImage.createGraphics();
    
    BufferedImage logoImage = ImageIO.read(new File(logoPath));
    
    int logoWidth = qrImage.getWidth() / 5;
    int logoHeight = qrImage.getHeight() / 5;
    int x = (qrImage.getWidth() - logoWidth) / 2;
    int y = (qrImage.getHeight() - logoHeight) / 2;
    
    // 绘制白色背景
    int borderSize = logoWidth / 10;
    graphics.setColor(Color.WHITE);
    graphics.fillRect(x - borderSize, y - borderSize, 
                     logoWidth + 2 * borderSize, logoHeight + 2 * borderSize);
    
    // 绘制Logo
    graphics.drawImage(logoImage, x, y, logoWidth, logoHeight, null);
    graphics.dispose();
    
    return qrImage;
}