使用Java代码制作二维码（超级简单）

🌟 引言

在移动互联网时代，二维码（QR Code）已成为信息传递、支付结算、身份认证、广告推广等场景中不可或缺的技术。从扫码加好友到移动支付，从电子票务到设备绑定，二维码无处不在。

作为 Java 开发者，如何在项目中快速、高效地生成二维码？本文将带你从零开始，手把手实现 Java 生成二维码的完整流程，涵盖主流库选型、核心代码解析、高级定制技巧以及生产环境建议，助你轻松掌握这一实用技能。

🧰 一、技术选型：主流二维码生成库对比

Java 生态中有多个成熟的二维码生成库，以下是两个最常用的方案：

✅ 本文推荐使用 ZXing：免费、开源、稳定，是企业级应用的首选。

🛠️ 二、环境准备与依赖引入

1. 添加 Maven 依赖

<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>

💡 提示：core 模块提供核心编码/解码能力，javase 提供图像 I/O 支持。

2. 项目结构建议

src/
├── main/
│   ├── java/
│   │   └── QRCodeGenerator.java
│   └── resources/
└── test/
    └── QRCodeTest.java

🧩 三、核心实现：生成二维码的四大步骤

✅ 步骤 1：设置编码参数（EncodeHintType）

通过 Map<EncodeHintType, Object> 配置二维码行为：

Map<EncodeHintType, Object> hints = new HashMap<>();
hints.put(EncodeHintType.CHARACTER_SET, "UTF-8");        // 支持中文
hints.put(EncodeHintType.ERROR_CORRECTION, ErrorCorrectionLevel.M); // 容错等级
hints.put(EncodeHintType.MARGIN, 2);                       // 边距（1-4）

🔍 参数说明：

✅ 步骤 2：创建 QRCodeWriter 并编码内容

String content = "https://www.example.com/user/123";
int width = 300;
int height = 300;

QRCodeWriter writer = new QRCodeWriter();
BitMatrix bitMatrix = writer.encode(content, BarcodeFormat.QR_CODE, width, height, hints);

📌 BitMatrix 是二维码的二进制矩阵表示，每个点对应一个像素。

✅ 步骤 3：将 BitMatrix 转换为图像

使用 MatrixToImageWriter 输出为 PNG、JPEG 等格式：

String filePath = "qrcode.png";
Path path = FileSystems.getDefault().getPath(filePath);
MatrixToImageWriter.writeToPath(bitMatrix, "PNG", path);

✅ 生成成功后，二维码图片将保存在指定路径。

🎨 四、高级定制：打造个性化二维码

1. 添加 Logo 图标（增强识别性）

在生成的二维码中心嵌入企业 Logo：

BufferedImage qrImage = MatrixToImageWriter.toBufferedImage(bitMatrix);
Graphics2D g = qrImage.createGraphics();

// 加载 logo 图片
BufferedImage logo = ImageIO.read(new File("logo.png"));
int x = (qrImage.getWidth() - logo.getWidth()) / 2;
int y = (qrImage.getHeight() - logo.getHeight()) / 2;
g.drawImage(logo, x, y, null);
g.dispose();

// 保存带 logo 的二维码
ImageIO.write(qrImage, "PNG", new File("qrcode_with_logo.png"));

⚠️ 建议：Logo 大小不超过二维码的 20%，避免影响扫描识别。

2. 自定义颜色与背景

public static BufferedImage toColorfulQR(BitMatrix matrix, int bgColor, int fgColor) {
    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) ? fgColor : bgColor);
        }
    }
    return image;
}

示例：深蓝背景 + 白色前景，提升视觉美感。

🧱 五、模块化封装：构建可复用的 QRCodeService

为了提高代码复用性，建议封装为服务类：

public class QRCodeService {

    public static BitMatrix generateBitMatrix(String content, int width, int height, Map<EncodeHintType, Object> hints) throws WriterException {
        QRCodeWriter writer = new QRCodeWriter();
        return writer.encode(content, BarcodeFormat.QR_CODE, width, height, hints);
    }

    public static void saveQRCodeImage(BitMatrix bitMatrix, String format, String filePath) throws IOException {
        Path path = FileSystems.getDefault().getPath(filePath);
        MatrixToImageWriter.writeToPath(bitMatrix, format, path);
    }

    public static Map<EncodeHintType, Object> getDefaultHints() {
        Map<EncodeHintType, Object> hints = new HashMap<>();
        hints.put(EncodeHintType.CHARACTER_SET, "UTF-8");
        hints.put(EncodeHintType.ERROR_CORRECTION, ErrorCorrectionLevel.M);
        hints.put(EncodeHintType.MARGIN, 2);
        return hints;
    }
}

✅ 可在 Web 接口、命令行工具、定时任务中灵活调用。

🌐 六、Web 集成：在 Spring Boot 中动态生成二维码

控制器示例（返回图片流）：

@RestController
public class QRCodeController {

    @GetMapping("/qrcode")
    public void getQRCode(HttpServletResponse response) throws Exception {
        String text = "User ID: 888888";
        BitMatrix matrix = QRCodeService.generateBitMatrix(text, 300, 300, QRCodeService.getDefaultHints());
        BufferedImage image = MatrixToImageWriter.toBufferedImage(matrix);

        response.setContentType("image/png");
        ImageIO.write(image, "PNG", response.getOutputStream());
    }
}

访问 http://localhost:8080/qrcode 即可实时生成并下载二维码。

⚠️ 七、注意事项与常见问题

📊 八、应用场景举例

🧑‍💻 总结

通过本文，你已掌握：

✅ 使用 ZXing 生成二维码的核心流程
✅ 参数配置、图像定制与 Logo 嵌入技巧
✅ 模块化封装与 Web 集成方法
✅ 生产环境中的避坑指南

🔚 二维码不仅是技术，更是连接物理世界与数字世界的桥梁。

掌握 Java 生成二维码的能力，将为你打开更多创新应用的大门。