# 做出扫得出来的 QR 码：内容格式、纠错级别与尺寸

> 网址、Wi-Fi 和联系人 QR 码里到底编码了什么，四个纠错级别如何在抗损坏能力和密度之间取舍，一个码最多能放多少内容，为什么输出图片的尺寸不一定是你选的那个，以及印刷前怎么测试。

- Tool: [QR 码生成器](https://toolsg.com/zh/qr-code-generator)
- Language: zh (available: en, zh, ms, ta)
- Last verified against official sources: 2026-10-18
- Source site: ToolSG — a planning guide, not official or financial advice. Cite the agencies listed under Sources.

## 关键数字一览

| 项目 | 数值 | 来源 |
| --- | --- | --- |
| 纠错级别 | L 约 7%，M 约 15%，Q 约 25%，H 约 30% — 码的一部分受损时，可以还原的数据比例。本工具默认使用 M。 | [Wikipedia](https://en.wikipedia.org/wiki/QR_code) |
| 最大的码（版本 40） | 177 × 177 个模块，L 级最多 2,953 字节 — H 级的上限降到 1,273 字节。纯数字在 L 级最多 7,089 位。 | [Denso Wave](https://www.qrcode.com/en/about/version.html) |
| 静区（边距） | 宽 4 个模块，本工具默认也是 4 — 码四周的空白边。边距栏可填 0 到 20，但印刷的码不要设为 0。 | [Denso Wave FAQ](https://www.qrcode.com/en/faq.html) |
| Wi-Fi 内容格式 | `WIFI:T:WPA;S:name;P:password;;` — 来自 ZXing 项目的文档格式。隐藏网络还需要多一个 H:true 字段，本工具不会添加。 | [ZXing wiki](https://github.com/zxing/zxing/wiki/Barcode-Contents) |
| 下载格式 | PNG、SVG 和 JPG — 宽度可选 128、256 或 512 像素。SVG 是矢量图，JPG 是有损格式。 |  |

## 做一个别人真能扫出来的 QR 码

QR 码扫不出来，多半是因为尺寸、对比度或内容写错了，而不是生成器的问题。

1. **选择内容类型** (第一步) — 网址或文本、Wi-Fi，或联系人名片。类型决定了最终编码的那串文字。
2. **内容尽量短** (生成之前) — 字符越少，模块越少也越大，扫描更快，印得差一点也还能读。长链接先缩短再编码。
3. **选择纠错级别** (在设置中) — 屏幕和干净的纸张用 M 就够了。贴纸、户外标牌或会磨损的表面选 Q 或 H。级别越高，码越密。
4. **设置尺寸、颜色和边距** (在设置中) — 浅色背景配深色码，保留默认的 4 个模块边距。印刷优先用 SVG，因为任何尺寸都保持清晰。
5. **发布前先测试** (最后) — 用两部不同的手机扫描实际的文件或印刷品。也可以用解码器把它读回来。 相关工具: [QR 码解码器](https://toolsg.com/zh/qr-code-decoder)

## 工具实际编码的内容

一个 QR 码只存一串文字。工具会根据你选的类型拼出这串文字：

| 类型 | 编码的文字 | 说明 |
| --- | --- | --- |
| 网址 / 文本 | 你输入的内容，去掉首尾空格 | 写上 `https://`，手机才会把它当作链接。 |
| Wi-Fi | `WIFI:T:WPA;S:HomeNet;P:secret123;;` | 安全类型为 WPA/WPA2、WEP 或无（`nopass`）。名称和密码里的 `\ ; , : "` 会按 ZXing 的规定用反斜杠转义。名称或密码首尾的空格会被去掉。不支持隐藏网络。 |
| 联系人 | 一段 vCard 3.0 文本，含 `FN`、`TEL`、`EMAIL` 和 `ORG` 行 | 至少要填姓名、电话或电子邮件之一。各字段按输入原样写入。 |

这段 vCard 有 `FN` 行，但没有 `N` 行，行尾也只是普通换行符。RFC 2426 要求必须有 `N`，值里的逗号和分号要转义，行尾用 CRLF。很多扫码软件仍然能处理，但请用你关心的那几部手机实测，并避免在字段里使用逗号和分号。

这个码是**静态**的。数据直接固化在图案里，之后无法修改，也没有扫描统计。静态码不会过期，但码里的链接只有在对应网页还在时才有用。本工具没有 Logo 叠加功能，也不会生成支付（例如 PayNow）所需的内容格式。

## 纠错与容量

里德-所罗门纠错让扫描器可以还原缺失的数据。级别越高，码里用于修复的部分越多，所以同样的内容需要更大、更密的码。

| 级别 | 约可还原 | 版本 40 最大文本（字节） | 汉字（UTF-8 每个 3 字节） |
| --- | --- | --- | --- |
| L | 7% | 2,953 | 984 |
| M | 15% | 2,331 | 777 |
| Q | 25% | 1,663 | 554 |
| H | 30% | 1,273 | 424 |

码的大小同时取决于内容和级别。以下数据用本工具所用的同一个库算出（每边的模块数，不含边距）：

| 内容 | 长度 | L | M | Q | H |
| --- | --- | --- | --- | --- | --- |
| `https://www.iras.gov.sg/` | 24 个字符 | 25 × 25 | 25 × 25 | 29 × 29 | 29 × 29 |
| `WIFI:T:WPA;S:HomeNet;P:secret123;;` | 34 个字符 | 25 × 25 | 29 × 29 | 29 × 29 | 33 × 33 |
| 带追踪参数的链接 | 109 个字符 | 41 × 41 | 45 × 45 | 49 × 49 | 57 × 57 |

纯数字最省空间（L 级 7,089 位，H 级 3,057 位），其次是大写字母加少量符号，再次是普通字节。小写网址使用字节模式。如果内容超出所选级别的容量，工具会显示生成错误，这时需要降低级别或缩短文字。

## 尺寸、颜色与边距

- **尺寸是目标值，不是保证值。** 宽度包含边距，并平均分给所有模块。使用默认边距时，25 模块的 IRAS 链接加边距共占 33 个模块，256 像素时每个模块 7.76 像素。109 个字符的链接在 M 级需要 53 个模块、H 级需要 65 个，同样 128 像素时每个模块只有 2.42 和 1.97 像素。如果每个模块的像素数不是整数，模块边缘会相差一个像素，所以印刷请用 SVG。
- **“小”也可能变大。** 如果码加边距比所选宽度还宽，库会忽略宽度，改为每个模块 4 像素。1,000 个字符的文本在 M 级是 121 个模块，所以选“小（128px）”会得到 516 像素的图片。256 和 512 这两个选项总是放得下。
- **颜色。** 使用深色前景配浅色背景，并保持强对比。用库生成的图实测：白底深红的码，本站的 [QR 码解码器](https://toolsg.com/zh/qr-code-decoder)读得出来；但深色背景配浅色码读不出来，浅灰底配中灰码也读不出来。其他扫码软件表现不一，所以反色码有风险。
- **边距。** 标准静区是 4 个模块。把它裁得太紧，是印刷的码扫不出来的常见原因。
- **格式。** SVG 放大不模糊，海报和贴纸用它。PNG 适合屏幕。JPG 是有损格式（质量 0.95），并保存在白色背景上。

> **提示：** 要在实际距离下扫描。3 米外读取的码要比名片上的大得多，这里的任何设置都改变不了这一点。

## 隐私

QR 码在你的浏览器中生成，不会发送到服务器。不过工具会在浏览器本地存储中保留你最近 20 个码的历史，包括 Wi-Fi 名称和**明文密码**。它会一直保留，直到你删除条目、点击“清除所有历史”或清除网站数据；关闭浏览器并不会删除。在共用电脑上请清除历史。

## 常见错误

- **链接没有写 `https://`。** 有些扫码软件会把它显示成纯文本。
- **对比度太低，或颜色反过来。**
- **印刷的码没有留边距。**
- **拉伸图片**，使模块不再是正方形。
- **内容很长还选最高级别。** 码变得太密，印出来模块太小。
- **使用短期有效的链接**，却期望印好的码一直有效。
- **把 Wi-Fi 密码放进公开展示的码里。** 任何人扫一下就能连上网络。

## 相关工具

- [QR 码解码器](https://toolsg.com/zh/qr-code-decoder) — 把码读回来，确认里面是什么。
- [图片格式转换器](https://toolsg.com/zh/image-converter) — 把下载的 PNG 转成其他格式。
- [文本转 Slug 工具](https://toolsg.com/zh/text-to-slug) — 生成简短干净的网址路径再去编码。

## 常见问题

**如何创建 QR 码？**

只需在输入字段中输入您的文本、URL 或数据，然后点击"生成 QR 码"。QR 码会立即创建并可供下载。

**QR 码生成器是免费的吗？**

是的，此 QR 码生成器完全免费，没有限制。无需注册或付款即可生成任意数量的 QR 码。

**我的 QR 码存储在您的服务器上吗？**

不，所有 QR 码生成都完全在您的浏览器中进行。您的数据永远不会离开您的设备，确保完全的隐私和安全。

**我可以自定义 QR 码的外观吗？**

可以，您可以自定义颜色、大小、纠错级别和边距。前景色与背景色要保持强对比，码才扫得出来。

**我应该使用什么错误纠正级别？**

对于干净的印刷使用低（7%），对于标准使用使用中（15%），对于损坏的表面使用四分位（25%），预期会有磨损时使用高（30%）。

**用于打印的 QR 码应该多大？**

对于打印，QR 码应至少为 2x2 厘米（0.8x0.8 英寸）。更大的尺寸更适合远距离扫描。打印时请下载 SVG，或至少下载 512px 的 PNG。

**我可以创建 PayNow QR 码吗？**

虽然这会生成标准 QR 码，但 PayNow QR 码具有特定格式。对于 PayNow，请使用您银行的官方应用或生成器以确保正确的格式和合规性。

**QR 码会过期吗？**

QR 码本身永不过期 - 它们是静态图像。但是，如果您的 QR 码链接到 URL，该网页可能会更改或被删除，从而有效地"破坏" QR 码。

**我可以跟踪 QR 码扫描吗？**

静态 QR 码无法跟踪。对于分析，请使用动态 QR 码服务。此工具创建静态 QR 码以实现隐私和简单性。


## 资料来源

- [Denso Wave — QR Code error correction](https://www.qrcode.com/en/about/error_correction.html) — Defines the correction function; confirms the M (15%) and Q (25%) figures.
- [Denso Wave — QR Code versions and capacity](https://www.qrcode.com/en/about/version.html) — Versions 1 to 40, from 21 × 21 to 177 × 177 modules.
- [Denso Wave — FAQ](https://www.qrcode.com/en/faq.html) — A white space of 4 modules is needed around the code; about 3 KB maximum at version 40, level L.
- [Wikipedia — QR code](https://en.wikipedia.org/wiki/QR_code) — All four correction levels and the version 40 capacity by data type.
- [ZXing wiki — Barcode Contents (Wi-Fi format and escaping)](https://github.com/zxing/zxing/wiki/Barcode-Contents)
- [RFC 2426 — vCard MIME Directory Profile (vCard 3.0)](https://www.rfc-editor.org/rfc/rfc2426)
- [node-qrcode — the library this tool uses](https://github.com/soldair/node-qrcode)
