JavaScript生成解析二维码方法详解

本文详细介绍了如何使用JavaScript在网页端高效实现二维码的生成与解析，涵盖三大主流场景：通过轻量级qrcode.js库快速生成自定义二维码、利用纯JS的jsQR库实现实时摄像头扫码识别、以及借助ZXing JavaScript版解析用户上传的图片文件中的二维码；文章不仅提供了清晰的引入方式、核心代码示例和关键配置说明，还强调了权限处理、兼容性及易被忽视的实践细节，为开发者提供了一站式、开箱即用的二维码交互解决方案。

JavaScript 可以通过第三方库轻松实现二维码的生成与解析。目前在浏览器和 Node.js 环境中都有成熟的支持方案，主要依赖 qrcode.js 用于生成，jsQR 或 ZXing 用于解析。

使用 qrcode.js 生成二维码

qrcode.js 是一个轻量级的库，适合在网页中将文本、链接等内容转换为二维码图像。

npm install qrcode

<script src="https://cdn.jsdelivr.net/npm/qrcode.js/lib/qrcode.min.js"></script>

基本使用示例（在页面中生成二维码）：

<div id="qrcode"></div>
<script>
  new QRCode(document.getElementById("qrcode"), "https://example.com");
</script>

可配置参数如大小、颜色、容错级别：

const qrcode = new QRCode(document.getElementById("qrcode"), {
  text: "Hello, World!",
  width: 128,
  height: 128,
  colorDark: "#000000",
  colorLight: "#ffffff",
  correctLevel: QRCode.CorrectLevel.H
});

使用 jsQR 解析二维码

jsQR 是一个纯 JavaScript 的二维码解码库，适用于从图像或视频流中读取二维码内容，常用于扫码功能。

<script src="https://cdn.jsdelivr.net/npm/jsqr@1.4.0/dist/jsQR.min.js"></script>

使用流程通常包括：获取图像数据（来自 canvas 或 video），调用 jsQR 解码。

示例：从摄像头读取二维码

<video id="video" width="300" height="300" autoplay></video>
<canvas id="canvas" style="display: none;"></canvas>

<script>
  const video = document.getElementById("video");
  const canvas = document.getElementById("canvas");
  const ctx = canvas.getContext("2d");

  navigator.mediaDevices.getUserMedia({ video: { facingMode: "environment" } })
    .then(stream => {
      video.srcObject = stream;
      setTimeout(scan, 500); // 延迟开始扫描
    });

  function scan() {
    if (video.readyState === video.HAVE_ENOUGH_DATA) {
      canvas.width = video.videoWidth;
      canvas.height = video.videoHeight;
      ctx.drawImage(video, 0, 0, canvas.width, canvas.height);
      const imageData = ctx.getImageData(0, 0, canvas.width, canvas.height);

      const code = jsQR(imageData.data, imageData.width, imageData.height);
      if (code) {
        console.log("识别到二维码:", code.data);
        alert("结果: " + code.data);
      }
    }
    setTimeout(scan, 500);
  }
</script>

使用 ZXing 进行图像文件解析

ZXing 的 JavaScript 版本也支持从图片文件中解析二维码，适合上传图片后读取场景。

<script src="https://unpkg.com/@zxing/library@latest/distribution/index.min.js"></script>

示例：上传图片并解析二维码

<input type="file" id="fileInput" />
<img id="image" />

<script>
  const codeReader = new ZXing.BrowserQRCodeReader();

  document.getElementById("fileInput").addEventListener("change", async (e) => {
    const file = e.target.files[0];
    const img = document.getElementById("image");
    img.src = URL.createObjectURL(file);

    img.onload = async () => {
      try {
        const result = await codeReader.decodeFromImageElement(img);
        console.log("解析结果:", result.text);
        alert("内容: " + result.text);
      } catch (err) {
        console.error("解析失败:", err);
        alert("未检测到二维码");
      }
    };
  });
</script>

基本上就这些。生成用 qrcode.js，实时扫描用 jsQR，文件解析可用 ZXing。根据实际场景选择合适的方法即可。注意权限处理（如摄像头访问）和兼容性测试。不复杂但容易忽略细节。

到这里，我们也就讲完了《JavaScript生成解析二维码方法详解》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！