Java初学者项目实战：如何开发一个简易的二维码生成器

二维码生成是很多Java项目中会用到的功能，对于初学者来说，开发一个简易的二维码生成器可以很好地把基础语法和实际应用场景结合起来，不需要复杂的业务逻辑就能完成一个可运行的小工具。

开发环境准备

开发这个简易二维码生成器需要准备以下内容：

• JDK 8及以上版本，确保本地Java环境配置正确
• 任意Java开发工具，比如IntelliJ IDEA或者Eclipse
• Google ZXing依赖，这是Google开源的二维码处理工具库，支持生成和解析多种格式的条码

引入核心依赖

如果使用Maven管理项目，只需要在pom.xml文件中添加以下依赖即可，ZXing的核心包已经包含了二维码生成需要的所有类：

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

如果不使用Maven，也可以直接下载ZXing的jar包，导入到项目的类路径中即可。

核心代码编写

二维码生成的核心逻辑分为三步：设置二维码参数、生成二维码矩阵、把矩阵渲染成图片并输出。下面是完整的实现代码：

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.client.j2se.MatrixToImageWriter;

import java.io.File;
import java.nio.file.Path;
import java.util.HashMap;
import java.util.Map;

public class QrCodeGenerator {
    // 二维码宽度
    private static final int WIDTH = 300;
    // 二维码高度
    private static final int HEIGHT = 300;
    // 二维码图片格式
    private static final String FORMAT = "png";

    public static void generateQrCode(String content, String outputPath) {
        try {
            // 设置二维码参数
            Map<EncodeHintType, Object> hints = new HashMap<>();
            // 设置字符编码，避免中文乱码
            hints.put(EncodeHintType.CHARACTER_SET, "UTF-8");
            // 设置纠错等级，L为约7%纠错
            hints.put(EncodeHintType.ERROR_CORRECTION, com.google.zxing.qrcode.decoder.ErrorCorrectionLevel.L);
            // 设置二维码边距
            hints.put(EncodeHintType.MARGIN, 1);

            // 生成二维码矩阵
            MultiFormatWriter writer = new MultiFormatWriter();
            BitMatrix bitMatrix = writer.encode(content, BarcodeFormat.QR_CODE, WIDTH, HEIGHT, hints);

            // 定义输出路径
            Path path = new File(outputPath).toPath();
            // 把矩阵渲染成图片并输出
            MatrixToImageWriter.writeToPath(bitMatrix, FORMAT, path);
            System.out.println("二维码生成成功，路径为：" + outputPath);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    public static void main(String[] args) {
        // 要编码到二维码中的内容
        String content = "https://ipipp.com";
        // 二维码输出路径
        String outputPath = "D:/qrcode.png";
        generateQrCode(content, outputPath);
    }
}

代码逻辑说明

上面的代码主要用到了ZXing提供的几个核心类：

• MultiFormatWriter：用于生成多种类型的条码矩阵，这里指定生成QR_CODE类型的矩阵
• BitMatrix：表示二维码的像素矩阵，每个元素对应一个像素点的黑白状态
• MatrixToImageWriter：负责把像素矩阵转换成图片文件并输出到指定路径

在参数设置部分，EncodeHintType.CHARACTER_SET设置为UTF-8是为了保证中文内容可以正常编码，不会出现乱码问题。ERROR_CORRECTION设置纠错等级，等级越高二维码被遮挡后还能识别的概率越大，但是对应的二维码密度也会更高。

运行验证

运行main方法之后，如果控制台输出二维码生成成功的提示，就可以到对应的输出路径查看生成的二维码图片。用手机扫描这个二维码，就可以看到我们编码进去的内容，比如上面代码中编码的是https://ipipp.com，扫描后就会跳转到对应的地址。

如果需要修改二维码的内容，只需要修改main方法中的content变量的值即可，如果需要调整二维码的大小，修改WIDTH和HEIGHT常量的值就可以实现。

Java二维码生成QR_CodeGoogle_ZXing修改时间：2026-06-23 00:06:41