二维码生成器指南：如何创建自定义二维码，支持URL、vCard和Wi-Fi编码

Last updated: June 28, 2026

QR code 是一种二维条形码，手机摄像头扫描它后可以打开 URL、分享联系信息、加入 Wi-Fi 或发送消息。生成一个 QR code 很简单；但要生成一个能可靠扫描的 QR code，主要取决于三个因素：足够的纠错能力、高对比度和适合扫描距离的物理尺寸。本指南将介绍 QR code 编码的内容、如何生成自定义代码，以及哪些错误会导致代码无法扫描。

Quick answer: how do you generate a QR code?

如果代码用于一个活动图形，请使用 image resizer 准备周围的艺术作品，并在 social media image sizes guide 中检查目标尺寸。对于单个代码，请使用 QR Code Generator；对于批量代码，可以使用 qrcode Python library 或 qrencode CLI。

What can a QR code encode?

QR codes 不仅仅是 URLs — 它们可以编码多种手机识别并执行的数据类型：

• URL — 打开网页（最常见的用途）。
• vCard — 向手机通讯录添加联系人。
• Wi-Fi — 加入 Wi-Fi 网络（嵌入 SSID + 密码）。
• SMS / email / phone — 打开消息或拨打电话。
• Plain text — 任何字符串，显示为文本。

数据类型编码在 QR code 的 payload 中，因此扫描的手机知道该做什么。URL QR code 会打开浏览器；Wi-Fi QR code 会打开网络连接提示。

How do you generate a QR code?

Browser generator

对于单个代码，请使用 QR Code Generator：选择类型（URL, vCard, Wi-Fi），输入数据，可选设置品牌颜色或 logo，然后下载 PNG/SVG。SVG 更适合打印，因为它在不失真的情况下进行缩放。

Command line (qrencode)

## Generate a URL QR as PNG
qrencode -o qr.png -s 20 -m 2 "https://imagic-ai.com"

## As SVG (for print)
qrencode -o qr.svg -t SVG "https://imagic-ai.com"

Python (qrcode)

import qrcode
qr = qrcode.QRCode(box_size=20, border=2, error_correction=qrcode.constants.ERROR_CORRECT_M)
qr.add_data("https://imagic-ai.com")
qr.make(fit=True)
qr.make_image(fill_color="black", back_color="white").save("qr.png")

对于批量代码（来自 CSV 的数百个代码），Python 库是合适的工具。

What is error correction and why does it matter?

QR codes 内置了 error correction (Reed-Solomon) 功能，即使部分损坏、脏污或覆盖 logo，它们仍然可以扫描。它有四个级别：

更高的纠错能力允许您在中心放置 logo 或抵抗磨损，但这会使代码更密集（更多模块）。当添加 logo 或为室外使用进行打印时，请使用 H；M 对于大多数情况是足够的。

How do you brand a QR code without breaking it?

您可以更改前景色并添加中心 logo，但两者都存在影响可扫描性的风险：

• Color: 保持高对比度——深色前景色配白色背景是最安全的。避免低对比度的组合（黄色配白色）。ISO/IEC 18004 QR code standard 定义了规范；来自 Google's QR code best practices 的实际扫描指南也强调了高对比度规则。
• Logo: 保持尺寸小（低于 ~30% 的面积）并居中，并且使用 error correction H，这样即使 logo 覆盖中心，代码仍然可以扫描。
• Shape: 保持三个角落的“finder”图案完整；它们是扫描仪定位和定向代码的方式。

在将品牌化代码打印到任何昂贵的地方之前，务必用真实手机进行测试。

What size should a printed QR code be?

经验法则：代码的尺寸至少应等于扫描距离的 1/10 倍。从 1 meter（海报）处扫描的代码需要 ~10cm；从 20cm（名片）处扫描的代码需要 ~2cm。如果比这个尺寸更小，手机摄像头就难以解析模块。对于打印，请导出为 SVG，以确保任何尺寸下都保持清晰。

Static vs dynamic QR codes

• Static: 数据直接编码在代码中。生成后无法更改目标地址。最适合 Wi-Fi、vCard 和永久 URL。
• Dynamic: 代码编码一个短重定向 URL；目标地址可以稍后更改（并且可以跟踪扫描）。这需要服务器，通常是付费服务。最适合您可能更改着陆页的营销活动。

选择取决于成本和灵活性。静态代码永远免费，且不依赖任何服务——即使生成公司消失了，它仍然有效，因为数据本身就存在于代码中。动态代码需要花费金钱，并且依赖重定向服务器保持运行，但它可以让您在打印后更改目标地址（修正一个拼写错误、更换活动），并统计扫描次数。实际应用划分：使用静态代码用于任何必须永久工作且没有持续成本的材料（名片、Wi-Fi 标识、产品手册）；使用动态代码用于需要分析和重定向能力的有时限营销活动。两者混合使用很常见——用静态代码处理永久材料，用动态代码处理活动推广。

Common mistakes

• Low contrast. 在彩色背景上的模糊代码无法扫描。请使用深色配浅色。
• Logo too large. 覆盖了数据；请使用 error correction H 并保持 logo 小于 30%。
• Too small for the distance. 名片上一个 1cm 的代码，从房间另一端是无法扫描的。
• Damaged finder patterns. 三个角落的方块必须保持完整。
• Rasterizing for print. 使用 SVG，以确保缩放时代码仍然清晰。

Frequently asked questions

Do QR codes expire?

静态代码永不过期——数据在代码中。动态代码（重定向 URL）只有在重定向服务关闭时才会过期。

Can a QR code have a logo?

可以——将一个小 logo 放在中心，并使用 error correction H。保持其面积低于 ~30%。

What is the best error correction level?

通用使用用 M；添加 logo 或用于室外/磨损风险时使用 H。QR code Wikipedia article 详细介绍了这些级别。

Can I track QR code scans?

只能通过动态 QR code（带有分析的重定向 URL）进行跟踪。静态代码无法被跟踪。

What can a QR code encode?

URL、纯文本、vCard（联系人）、Wi-Fi 网络、电子邮件、SMS 或日历事件。URL 是最常见的。数据类型决定了扫描仪如何处理结果——URL 在浏览器中打开，vCard 添加联系人，Wi-Fi 代码加入网络。

What is error correction and why does it matter?

纠错能力是一种冗余性，即使代码的一部分受损或被覆盖，QR code 仍然可以扫描（最高级别可达 30%）。更高的纠错能力会使代码更大、更密集。当代码可能磨损或您需要叠加 logo 时使用它——中心位置是放置小 logo 最安全的区域。

What size should a printed QR code be?

足够大，以便从预期的距离扫描到——对于 2-foot 的扫描，大约需要 1 inch；对于更远的距离，则需要更大。代码越小，扫描仪就必须离得越近。在批量生产之前，请用手机测试打印尺寸，因为过小的代码会直接无法扫描。

What is a dynamic QR code?

一种编码短重定向 URL 而不是最终目的地的 QR code，因此您可以在不重新打印代码的情况下更改其指向位置，并记录扫描次数以进行分析。静态 QR code 直接编码目标地址，不能更改或跟踪。动态代码成本更高，但更灵活、可衡量。

How do I brand a QR code without breaking it?

保持品牌颜色高对比度（深色配浅色），并且绝不要覆盖超过纠错级别允许的范围——中心位置对小 logo 最安全。在打印之前，请务必用真实扫描仪测试品牌化代码，因为低对比度或过度覆盖会破坏扫描，而一个无法扫描的 QR code 仅仅是装饰品。

Can a QR code be too small to scan?

可以——低于大约 1 inch，大多数手机摄像头都会遇到困难，尤其是在远距离的情况下。请根据扫描距离设置代码尺寸：越远需要越大。在批量生产之前，请用手机测试打印尺寸，因为过小的代码会直接无法扫描，仅仅是装饰品。

Image credits

• QR-code example, branded QR, and what-qr-encodes diagrams — the QR codes are real, generated by the author with the Python qrcode library encoding https://imagic-ai.com; the encoding-types diagram is author-illustrated.