QR Code（Quick Response Code，快速响应码）是一种二维条码，能够存储大量数据并支持快速扫描识别。从移动支付到产品追溯，二维码已经深入我们生活的方方面面。本指南将全面介绍QR Code的编码原理、技术细节和最佳实践。
目录
核心要点
- 高容量存储：QR Code最多可存储7,089个数字字符或4,296个字母数字字符。
- 快速识别：三个定位图案使扫描器能够从任意角度快速定位和读取。
- 强大纠错：支持四种纠错级别（L/M/Q/H），最高可恢复30%的损坏数据。
- 多种编码模式：支持数字、字母数字、字节和汉字四种编码模式。
- 40个版本：从21×21到177×177像素，满足不同数据容量需求。
- 广泛应用：支付、营销、物流、身份验证等场景广泛使用。
需要快速生成二维码？试试我们支持多种格式和自定义选项的免费在线工具。
什么是QR Code？
QR Code（Quick Response Code）是由日本电装公司（Denso Wave）于1994年发明的二维条码。与传统一维条码只能水平方向存储数据不同，QR Code在水平和垂直两个方向都能存储信息，因此具有更高的数据密度。
QR Code的关键特性：
- 高数据密度：相比传统条码，存储容量提升数十倍
- 全方位识别：支持360度任意角度扫描
- 容错能力：即使部分损坏也能正确读取
- 快速解码：专门设计用于高速读取
QR Code的结构解析
一个标准的QR Code由多个功能区域组成：
┌─────────────────────────────────────┐
│ ▓▓▓▓▓▓▓ ░░░░░░░░░░░░░░░ ▓▓▓▓▓▓▓ │
│ ▓░░░░░▓ ░░░░░░░░░░░░░░░ ▓░░░░░▓ │
│ ▓░▓▓▓░▓ ░░░░░░░░░░░░░░░ ▓░▓▓▓░▓ │
│ ▓░▓▓▓░▓ ░░░ 数据区域 ░░░ ▓░▓▓▓░▓ │
│ ▓░▓▓▓░▓ ░░░░░░░░░░░░░░░ ▓░▓▓▓░▓ │
│ ▓░░░░░▓ ░░░░░░░░░░░░░░░ ▓░░░░░▓ │
│ ▓▓▓▓▓▓▓ ░▓░▓░▓░▓░▓░▓░▓░ ▓▓▓▓▓▓▓ │
│ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ │
│ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ │
│ ░░░░░░░░░ 数据和纠错码 ░░░░░░░░░░ │
│ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ │
│ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ │
│ ▓▓▓▓▓▓▓ ░░░░░░░░░░░░░░░░░░░░░░░░ │
│ ▓░░░░░▓ ░░░░░░░░░░░░░░░░░░░░░░░░ │
│ ▓░▓▓▓░▓ ░░░░░░░░░░░░░░░░░░░░░░░░ │
│ ▓░▓▓▓░▓ ░░░░░░░░░░░░░░░░░░░░░░░░ │
│ ▓░▓▓▓░▓ ░░░░░░░░░░░░░░░░░░░░░░░░ │
│ ▓░░░░░▓ ░░░░░░░░░░░░░░░░░░░░░░░░ │
│ ▓▓▓▓▓▓▓ ░░░░░░░░░░░░░░░░░░░░░░░░ │
└─────────────────────────────────────┘
定位图案
QR Code的三个角落各有一个7×7模块的定位图案（Finder Pattern）。这些图案具有独特的1:1:3:1:1比例，无论从哪个方向扫描都能被快速识别。
▓▓▓▓▓▓▓
▓░░░░░▓
▓░▓▓▓░▓
▓░▓▓▓░▓
▓░▓▓▓░▓
▓░░░░░▓
▓▓▓▓▓▓▓
定位图案的作用：
- 帮助扫描器确定QR Code的位置和方向
- 计算QR Code的倾斜角度
- 确定模块大小
时序图案
时序图案（Timing Pattern）是连接三个定位图案的交替黑白模块线条，用于帮助扫描器确定模块的坐标位置。
水平时序：▓░▓░▓░▓░▓░▓░▓
垂直时序：同样的交替模式
格式信息
格式信息区域存储两个关键参数：
- 纠错级别（2位）：L、M、Q、H四种级别
- 掩码图案（3位）：8种掩码图案之一
格式信息经过BCH编码，具有一定的纠错能力。
数据区域
数据区域存储实际的编码数据和纠错码。数据按照特定的路径填充到模块中，通常是从右下角开始，以蛇形路径向上移动。
数据编码模式
QR Code支持四种主要的编码模式，每种模式针对不同类型的数据进行了优化：
| 模式 | 模式指示符 | 支持字符 | 每字符位数 |
|---|---|---|---|
| 数字模式 | 0001 | 0-9 | 3.33位 |
| 字母数字模式 | 0010 | 0-9, A-Z, 空格, $%*+-./: | 5.5位 |
| 字节模式 | 0100 | ISO 8859-1 / UTF-8 | 8位 |
| 汉字模式 | 1000 | Shift JIS字符 | 13位 |
数字模式编码示例
数字模式将数字分成3位一组，每组转换为10位二进制：
输入: "01234567"
分组: "012" "345" "67"
编码: 012 → 0000001100 (10位)
345 → 0101011001 (10位)
67 → 1000011 (7位，最后不足3位)
字母数字模式编码示例
字母数字模式将字符映射到0-44的值，两个字符组合编码为11位：
字符值表: 0-9→0-9, A-Z→10-35, 空格→36, $→37, %→38...
输入: "AC-42"
分组: "AC" "-4" "2"
编码: AC → (10×45+12) = 462 → 00111001110 (11位)
-4 → (41×45+4) = 1849 → 11100111001 (11位)
2 → 2 → 000010 (6位，单字符)
纠错机制详解
QR Code的纠错能力是其最重要的特性之一，使用Reed-Solomon纠错码来实现。
四种纠错级别
| 级别 | 名称 | 纠错能力 | 适用场景 |
|---|---|---|---|
| L | Low | ~7% | 数据量大，环境干净 |
| M | Medium | ~15% | 一般用途（默认推荐） |
| Q | Quartile | ~25% | 工业环境，可能有污损 |
| H | High | ~30% | 恶劣环境，需要logo覆盖 |
Reed-Solomon纠错码
Reed-Solomon（RS）码是一种强大的纠错编码，广泛应用于CD、DVD、QR Code等领域。
工作原理：
- 数据多项式：将数据视为有限域GF(2^8)上的多项式系数
- 生成多项式：使用特定的生成多项式计算纠错码
- 纠错码计算：数据多项式除以生成多项式，余数即为纠错码
设数据多项式为 D(x)，生成多项式为 G(x)
纠错码 E(x) = D(x) × x^n mod G(x)
其中 n 是纠错码的字节数
纠错能力计算：
RS码可以纠正的错误数量为：
- 纠错字节数 = 2t（t为可纠正的错误符号数）
- 如果有e个错误和r个擦除：2e + r ≤ 2t
QR Code版本与容量
QR Code有40个版本，版本号决定了二维码的大小和数据容量：
| 版本 | 模块数 | 数字容量(L) | 字母数字容量(L) | 字节容量(L) |
|---|---|---|---|---|
| 1 | 21×21 | 41 | 25 | 17 |
| 2 | 25×25 | 77 | 47 | 32 |
| 5 | 37×37 | 154 | 93 | 64 |
| 10 | 57×57 | 652 | 395 | 271 |
| 20 | 97×97 | 1,903 | 1,153 | 792 |
| 40 | 177×177 | 7,089 | 4,296 | 2,953 |
版本选择公式：
模块数 = 17 + (版本号 × 4)
例如：版本10 = 17 + (10 × 4) = 57 模块
代码示例
JavaScript
// 使用 qrcode 库生成二维码
// npm install qrcode
import QRCode from 'qrcode';
// 生成二维码数据URL（用于在网页中显示）
async function generateQRCodeDataURL(text, options = {}) {
const defaultOptions = {
errorCorrectionLevel: 'M',
type: 'image/png',
width: 256,
margin: 2,
color: {
dark: '#000000',
light: '#ffffff'
}
};
const config = { ...defaultOptions, ...options };
try {
const dataURL = await QRCode.toDataURL(text, config);
return dataURL;
} catch (error) {
console.error('生成二维码失败:', error);
throw error;
}
}
// 生成二维码到Canvas
async function generateQRCodeToCanvas(canvas, text, options = {}) {
await QRCode.toCanvas(canvas, text, {
errorCorrectionLevel: 'H',
width: 300,
...options
});
}
// 生成SVG格式二维码
async function generateQRCodeSVG(text) {
const svgString = await QRCode.toString(text, {
type: 'svg',
errorCorrectionLevel: 'M'
});
return svgString;
}
// 使用示例
const qrDataURL = await generateQRCodeDataURL('https://qubittool.com', {
errorCorrectionLevel: 'H',
width: 512
});
console.log('二维码已生成:', qrDataURL);
Python
import qrcode
from qrcode.constants import ERROR_CORRECT_L, ERROR_CORRECT_M, ERROR_CORRECT_Q, ERROR_CORRECT_H
from PIL import Image
import io
import base64
def generate_qrcode(data: str,
error_correction: str = 'M',
box_size: int = 10,
border: int = 4,
fill_color: str = 'black',
back_color: str = 'white') -> Image.Image:
"""
生成QR Code二维码
参数:
data: 要编码的数据
error_correction: 纠错级别 ('L', 'M', 'Q', 'H')
box_size: 每个模块的像素大小
border: 边框宽度（模块数）
fill_color: 前景色
back_color: 背景色
返回:
PIL Image对象
"""
error_levels = {
'L': ERROR_CORRECT_L,
'M': ERROR_CORRECT_M,
'Q': ERROR_CORRECT_Q,
'H': ERROR_CORRECT_H
}
qr = qrcode.QRCode(
version=None, # 自动选择版本
error_correction=error_levels.get(error_correction, ERROR_CORRECT_M),
box_size=box_size,
border=border
)
qr.add_data(data)
qr.make(fit=True)
img = qr.make_image(fill_color=fill_color, back_color=back_color)
return img
def generate_qrcode_with_logo(data: str,
logo_path: str,
logo_size_ratio: float = 0.3) -> Image.Image:
"""
生成带Logo的二维码（使用H级纠错以确保可读性）
"""
qr = qrcode.QRCode(
error_correction=ERROR_CORRECT_H,
box_size=10,
border=4
)
qr.add_data(data)
qr.make(fit=True)
qr_img = qr.make_image(fill_color='black', back_color='white').convert('RGB')
logo = Image.open(logo_path)
qr_width, qr_height = qr_img.size
logo_max_size = int(qr_width * logo_size_ratio)
logo.thumbnail((logo_max_size, logo_max_size), Image.Resampling.LANCZOS)
logo_pos = ((qr_width - logo.size[0]) // 2, (qr_height - logo.size[1]) // 2)
qr_img.paste(logo, logo_pos)
return qr_img
def qrcode_to_base64(img: Image.Image, format: str = 'PNG') -> str:
"""将二维码图片转换为Base64字符串"""
buffer = io.BytesIO()
img.save(buffer, format=format)
return base64.b64encode(buffer.getvalue()).decode()
# 使用示例
if __name__ == '__main__':
# 生成基本二维码
qr_img = generate_qrcode(
'https://qubittool.com/zh/tools/qrcode-generator',
error_correction='H',
box_size=10
)
qr_img.save('qrcode.png')
# 获取二维码信息
print(f"二维码尺寸: {qr_img.size}")
print(f"Base64长度: {len(qrcode_to_base64(qr_img))}")
Go
package main
import (
"image/png"
"os"
"github.com/skip2/go-qrcode"
)
// ErrorCorrectionLevel 纠错级别
type ErrorCorrectionLevel int
const (
Low ErrorCorrectionLevel = iota // 7% 纠错
Medium // 15% 纠错
High // 25% 纠错
Highest // 30% 纠错
)
// GenerateQRCode 生成二维码并保存为PNG文件
func GenerateQRCode(content string, level qrcode.RecoveryLevel, size int, filename string) error {
return qrcode.WriteFile(content, level, size, filename)
}
// GenerateQRCodeBytes 生成二维码并返回PNG字节数据
func GenerateQRCodeBytes(content string, level qrcode.RecoveryLevel, size int) ([]byte, error) {
return qrcode.Encode(content, level, size)
}
// GenerateQRCodeWithColor 生成自定义颜色的二维码
func GenerateQRCodeWithColor(content string, level qrcode.RecoveryLevel, size int, filename string) error {
qr, err := qrcode.New(content, level)
if err != nil {
return err
}
qr.DisableBorder = false
file, err := os.Create(filename)
if err != nil {
return err
}
defer file.Close()
return png.Encode(file, qr.Image(size))
}
func main() {
// 生成基本二维码
err := GenerateQRCode(
"https://qubittool.com/zh/tools/qrcode-generator",
qrcode.High, // 使用高纠错级别
256,
"qrcode.png",
)
if err != nil {
panic(err)
}
// 生成二维码字节数据
pngData, err := GenerateQRCodeBytes(
"Hello, QR Code!",
qrcode.Medium,
512,
)
if err != nil {
panic(err)
}
println("二维码PNG数据大小:", len(pngData), "字节")
}
最佳实践
1. 选择合适的纠错级别
| 使用场景 | 推荐级别 | 原因 |
|---|---|---|
| 网页链接、数字内容 | L 或 M | 数据量小，显示环境好 |
| 印刷品、名片 | M | 平衡容量和纠错 |
| 工业标签、户外 | Q 或 H | 可能有污损、磨损 |
| 需要嵌入Logo | H | Logo会遮挡部分数据 |
2. 优化数据编码
// 优化URL长度
// 差：https://www.example.com/products/item?id=12345&ref=qrcode
// 好：https://example.com/p/12345
// 使用短链接服务
// 差：https://qubittool.com/zh/tools/qrcode-generator?utm_source=print&utm_medium=flyer
// 好：https://qbt.io/qr
// 纯数字数据使用数字模式
// 数据 "1234567890" 使用数字模式比字节模式节省约60%空间
3. 确保足够的对比度
/* 推荐的颜色对比度 */
.qrcode-good {
/* 深色前景，浅色背景 */
--foreground: #000000;
--background: #ffffff;
}
.qrcode-acceptable {
/* 深蓝色前景，浅色背景 */
--foreground: #1a365d;
--background: #f7fafc;
}
/* 避免的配色 */
.qrcode-bad {
/* 对比度不足 */
--foreground: #718096;
--background: #a0aec0;
}
4. 保持足够的静默区
二维码周围需要保持至少4个模块宽度的空白区域（静默区），确保扫描器能正确识别边界。
推荐静默区宽度：
- 最小：4个模块
- 推荐：4-8个模块
- 印刷品：建议6-8个模块
5. 测试不同设备和环境
// 生成测试用二维码的检查清单
const testChecklist = [
'在不同光照条件下测试',
'使用多种手机型号测试',
'测试不同扫描App',
'验证打印后的可读性',
'测试最小可识别尺寸',
'检查Logo覆盖后的可读性'
];
常见应用场景
1. 移动支付
二维码支付是目前最广泛的应用场景：
- 静态码：商户展示固定收款码
- 动态码：每笔交易生成唯一二维码
- 安全考虑：使用短有效期、金额限制
2. 产品溯源
二维码内容示例：
{
"product_id": "SKU123456",
"batch": "2026-01-12-A",
"factory": "深圳工厂",
"trace_url": "https://trace.example.com/SKU123456"
}
3. 身份验证
- 电子票务（演唱会、机票、火车票）
- 会员卡和优惠券
- 门禁系统
4. 营销推广
- 产品包装引导到详情页
- 线下广告引流到线上
- 社交媒体账号关注
5. 信息分享
- WiFi连接信息
- 电子名片（vCard）
- 地理位置坐标
WiFi二维码格式：
WIFI:T:WPA;S:网络名称;P:密码;;
vCard格式：
BEGIN:VCARD
VERSION:3.0
N:张;三
TEL:+86-138-0000-0000
EMAIL:zhangsan@example.com
END:VCARD
常见问题
二维码最多能存储多少数据？
QR Code的最大容量取决于版本和纠错级别：
- 数字：最多7,089个字符（版本40，L级纠错）
- 字母数字：最多4,296个字符
- 字节数据：最多2,953字节
- 汉字：最多1,817个字符
实际应用中，建议将数据控制在500字节以内，以确保良好的扫描体验。
如何选择合适的二维码尺寸？
二维码的最小尺寸取决于：
- 扫描距离
- 打印分辨率
- 数据量（版本）
经验公式：
最小尺寸(mm) ≈ 扫描距离(mm) / 10
例如：
- 手机近距离扫描（10-30cm）：建议 2-3cm
- 海报远距离扫描（1-2m）：建议 10-20cm
二维码可以使用彩色吗？
可以，但需要注意：
- 前景色必须比背景色深
- 对比度至少保持在40%以上
- 避免使用渐变色
- 红色和绿色对比度可能不足
如何在二维码中嵌入Logo？
- 使用H级（30%）纠错级别
- Logo大小不超过二维码面积的30%
- Logo放置在中心位置
- 确保Logo边缘清晰
- 生成后务必测试可读性
二维码和条形码有什么区别？
| 特性 | 一维条形码 | QR Code |
|---|---|---|
| 数据方向 | 水平 | 水平+垂直 |
| 数据容量 | 约20字符 | 最多7000+字符 |
| 纠错能力 | 无 | 7%-30% |
| 扫描角度 | 水平 | 360度 |
| 数据类型 | 仅数字/字母 | 任意二进制 |
如何不写代码生成二维码？
你可以使用在线工具，如我们的免费二维码生成器，无需编写任何代码即可快速生成各种格式的二维码，支持自定义颜色、尺寸和纠错级别。
总结
QR Code作为一种成熟的二维编码技术，凭借其高容量、强纠错和快速识别的特点，已经成为现代数字生活的重要组成部分。理解其编码原理和最佳实践，能够帮助你在各种应用场景中更好地使用二维码技术。
快速总结：
- 一般用途使用M级纠错，需要嵌入Logo使用H级
- 保持数据简洁，优先使用短链接
- 确保足够的对比度和静默区
- 生成后务必在多种设备上测试
- 根据扫描距离选择合适的尺寸
准备好生成二维码了吗？试试我们的免费在线工具：