二维码生成完整指南

二维码（QR Code，全称 Quick Response Code）由日本 DENSO WAVE 公司的工程师原昌宏于 1994 年发明。最初的设计目标是为了解决汽车零部件追踪问题——传统一维条码存储容量有限，每次扫描只能获取少量信息，而二维码通过二维矩阵的方式，在相同物理面积内可以存储数十倍于一维条码的数据量。

二维码的模块结构堪称工程设计的典范。一个标准的二维码由以下关键部分组成：

• 三个定位角（Finder Pattern）：位于左上角、右上角、左下角，每个都是 7×7 的嵌套方形图案。扫码器通过这三个"靶心"快速识别二维码的位置和方向，这使得二维码支持任意角度（360 度）扫描。
• 对齐图案（Alignment Pattern）：位于二维码右下角及其他位置，用于修正因曲面、倾斜或镜头畸变导致的图像变形。版本 2 及以上的二维码都包含至少一个对齐图案。
• 定时图案（Timing Pattern）：一条由黑白交替模块组成的水平线和垂直线，穿过定位角内侧，用于确定模块的精确位置和间距。
• 格式信息（Format Information）：位于定位角内侧，存储纠错级别和掩码模式编号。
• 数据区域（Data Area）：剩余空间按照 Zig-Zag（之字形）顺序填充编码后的数据和纠错码。
• 空白静区（Quiet Zone）：二维码四周的空白区域，至少为 4 个模块宽度。它帮助扫码器区分二维码与背景图案，对快速识别至关重要。

二维码的模块（Module）指的是每个黑白小方块，是二维码的最小单位。模块数 = 17 + 版本号 × 4。版本 1 的二维码有 21×21 = 441 个模块，版本 40 则有 177×177 = 31,329 个模块。

二维码标准定义了四种数据编码模式，不同模式针对不同类型的输入数据进行优化，以在有限的模块空间中存储尽可能多的信息：

1. 数字模式（Numeric Mode）：只存储数字 0-9，编码效率最高。每 3 个数字被压缩为 10 比特（二进制），对于纯数字内容（如电话号码、订单号），数字模式的存储密度是字节模式的约 2.5 倍。版本 40 + 级别 L 最多可存储 7,089 个数字字符。

2. 字母数字模式（Alphanumeric Mode）：存储数字 0-9、大写字母 A-Z、以及 9 个特殊符号（空格、$、%、*、+、-、.、/、:）。每 2 个字符被压缩为 11 比特，比字节模式效率高约 1.5 倍。版本 40 + 级别 L 最多可存储 4,296 个字符。

3. 字节模式（Byte Mode）：按照 ISO-8859-1 字符集存储，每个字符占用 8 比特。这是最通用的模式，适合存储普通文本、网址链接和混合内容。版本 40 + 级别 L 最多可存储 2,953 个字节。

4. 日文模式（Kanji Mode）：专门优化日文汉字和假名的存储，每个日文字符压缩为 13 比特，比字节模式效率高约 1.2 倍。版本 40 + 级别 L 最多可存储 1,817 个日文字符。

关于中文支持：二维码标准本身并没有原生支持中文的编码模式。行业通用的做法是使用字节模式 + UTF-8 编码来存储中文：每个中文字符在 UTF-8 中通常占用 3 个字节，因此在字节模式下一个中文需要 24 比特。版本 40 + 级别 L 的二维码可以存储约 980 个中文字符。本工具使用的正是这一标准方案，所有主流手机（iPhone、Android）的相机应用和微信、支付宝等扫码应用都完美支持 UTF-8 中文二维码。

一个实用经验：对于仅含数字或大写字母的内容（如短链接、优惠券码），使用数字或字母数字模式可以生成更小的二维码，从而提高打印和扫描的可靠性。

二维码最革命性的特性是其强大的容错能力，这得益于 Reed-Solomon 纠错算法（里德-所罗门码）。这一算法由 Irving S. Reed 和 Gustave Solomon 于 1960 年提出，最初用于深空通信（NASA 的旅行者号探测器即使用 Reed-Solomon 码来对抗宇宙噪声）。二维码标准在 1994 年采纳了这一算法，使得二维码即使在部分损坏或被遮挡的情况下仍能被正确扫描。

Reed-Solomon 纠错的原理是：在原始数据之外，额外生成并存储一定比例的冗余数据（纠错码）。扫描时，解码器可以利用这些冗余数据来重建缺失或损坏的部分。冗余数据的比例越高，可恢复的错误越多，但可存储的原始数据越少。

二维码标准定义了四个纠错级别：

• L（Low）：约 7% 恢复能力——冗余数据比例最低，在相同版本下可存储最多的原始数据。适合干净、平整、不会磨损的打印场景，如电子票屏幕展示、室内海报。版本 40 + L 级别最多可存储 7,089 个数字字符。
• M（Medium）：约 15% 恢复能力——最常用的默认级别，在纠错能力和数据密度之间取得了良好平衡。适合名片、菜单、产品标签、普通营销物料等大多数场景。是本工具的默认选项。版本 40 + M 级别最多可存储 5,596 个数字字符。
• Q（Quartile）：约 25% 恢复能力——适合较恶劣的环境，如户外广告（可能受到日晒雨淋和磨损）、工业标签、物流包装、长期存放的文档。版本 40 + Q 级别最多可存储 3,993 个数字字符。
• H（High）：约 30% 恢复能力——最高纠错级别。当您需要在二维码中心插入 Logo、图标或品牌标识时，强烈推荐使用 H 级别，因为 Logo 会遮挡约 15%-20% 的模块面积。H 级别也适合户外展示、长期保存、以及快速移动扫描等场景。版本 40 + H 级别最多可存储 3,057 个数字字符。

纠错级别与 Logo 的关系：当您在二维码中心放置 Logo 时，被覆盖的模块面积约为二维码总面积的 10%-20%。如果使用 L 或 M 级别，被 Logo 覆盖的模块可能超出了纠错算法的恢复能力，导致二维码无法被扫描。使用 H 级别（30% 恢复能力）可以确保即使中心有约 20% 的区域被 Logo 覆盖，仍有足够的冗余数据用于恢复原始信息。本工具在检测到您上传 Logo 后会自动切换到 H 级别，以最大程度保证二维码的可扫性。

二维码的版本从 1 到 40 共 40 个等级，每上升一个版本，每边的模块数增加 4 个，可存储的数据量随之增加。选择合适的版本是平衡二维码大小和信息容量的关键。

版本 1-10（小型二维码）：版本 1 为 21×21 模块，版本 10 为 57×57 模块。这些较小的版本适合存储短内容——版本 5（37×37模块）+ M 级别可存储约 100 个数字或 60 个字节，足以容纳一个短网址（URL）或简单的文本信息。小版本二维码印刷时占用空间小，适合名片、产品标签、徽章等场景。

版本 11-25（中型二维码）：版本 15 为 77×77 模块，版本 25 为 117×117 模块。这一区间是最常用的范围，适合存储中等长度的内容——版本 15 + M 级别可存储约 750 个数字或 450 个字节，版本 25 + M 级别可存储约 2,000 个数字或 1,200 个字节。适合应用场景：WiFi 配置二维码、vCard 电子名片、产品详情链接、包含简短描述的活动海报。

版本 26-40（大型二维码）：版本 40 为 177×177 模块，是标准二维码的最大版本。版本 40 + L 级别可存储 7,089 个数字字符或 2,953 个字节（约 2.9 KB 的纯文本）。大型二维码适合存储较长的内容，如完整的文章段落、JSON 数据、产品完整说明、加密凭证等。但需要注意：版本越高，二维码越大，打印时需要保证足够的物理尺寸（至少每模块 2-3 个像素，打印推荐每模块 0.25mm 以上），否则扫描时容易出现识别困难。

版本自动选择机制：本工具会根据您输入的内容长度和所选的纠错级别，自动选择能容纳该内容的最小可用版本。这意味着：对于同样的内容，选择更高的纠错级别（如 H）会导致使用更大的版本，二维码物理尺寸更大。反之，如果内容较短（如 "Hello"），即使选择 H 级别，工具仍会使用版本 1 或 2 生成一个紧凑的二维码。

WiFi 二维码的特殊格式：当使用 WiFi 模式时，内容按照标准格式编码：WIFI:T:WPA;S:网络名称;P:密码;;。这是由 ZXing 项目（Google 维护的开源条码库）推广的行业约定格式，iOS 11+、Android 10+ 原生相机以及微信、支付宝、QQ 等主流应用均完美支持。无需安装任何特殊 App，手机相机直接扫描即可连接 WiFi。

传统的二维码是纯黑白的，随着技术和审美的演进，自定义颜色和 Logo 已成为品牌营销中的常见需求。本节提供这些高级特性的最佳实践指南。

Logo 插入的原则：二维码中心区域的模块约占总面积的 10%-20%。基于 Reed-Solomon 纠错算法，即使这部分区域被完全遮挡，二维码仍可被恢复。Logo 正是利用这一特性——将品牌标识放置在二维码中心。但请注意以下原则：

• Logo 面积不超过二维码总面积的 20%，超过后即使是 H 级别纠错也可能无法恢复被遮挡的数据。
• 尽量选择简洁的 Logo——复杂、细节繁多的 Logo 在小尺寸二维码上会变得模糊不清，影响品牌识别效果。
• Logo 四周保留白色背景或白色边框，避免 Logo 颜色与二维码模块颜色混淆，干扰扫码器的模块识别。
• 始终使用 H 级别纠错——本工具在检测到您上传 Logo 后会自动切换到 H 级别。
• 生成后务必实际扫描测试，使用多款不同手机（iPhone、不同品牌的 Android）验证可扫性。

颜色自定义的原则：二维码不要求必须是"黑白"配色，但要求模块之间有足够的明暗对比度。颜色选择的关键原则：

• 前景色（模块颜色）必须比背景色深（亮度更低）。不建议使用亮色模块 + 深色背景的反色方案——虽然部分扫码器支持，但识别率会显著下降。
• 前景色与背景色的亮度对比度不低于 60%。推荐使用深色（蓝、黑、深绿、深紫）作为前景色，浅色（白、浅灰、米色）作为背景色。
• 避免同色系配色（如深蓝 + 浅蓝）——虽然人类眼睛可以分辨，但扫码器的传感器对相近亮度的颜色区分能力较差。
• 避免使用红色作为前景色。多数手机摄像头的 CMOS 传感器对红色通道的敏感度较低，红色模块可能被识别为背景。
• 当使用自定义颜色时，建议提高纠错级别到 Q 或 H，以补偿颜色对比度下降带来的识别率损失。

导出格式的选择：PNG 是最通用的格式，无损压缩、透明背景支持好，适合绝大多数场景；JPG 文件更小但会损失精度，不推荐用于包含精细模块的二维码；WEBP 在保持无损的同时文件更小，适合网页嵌入；SVG 是矢量格式，任意缩放不会失真，适合需要大幅打印的场景（如户外广告牌）。本工具支持所有四种格式的一键导出。

一个"看起来很漂亮"的二维码，如果扫码率低，就失去了实用价值。以下是影响扫码识别率的关键因素和优化策略：

1. 最小模块尺寸（Module Size）：二维码中的每个模块在打印或显示时需要有足够的物理尺寸，否则手机摄像头无法分辨。推荐的最小模块尺寸：屏幕展示时每模块 2-3 像素（例如一个 25×25 模块的二维码，在屏幕上至少需要 50×50 像素显示）；打印在纸张上时每模块 0.25 毫米（约 7 DPI 的 0.25mm）。更小的模块尺寸会导致远距扫描失败。

2. 空白静区（Quiet Zone）：二维码四周需要保留至少 4 个模块宽度的空白边距。这个空白区域的作用是帮助扫码器区分"二维码区域"和"背景区域"——尤其当二维码放置在复杂背景（如彩色海报、照片）上时，静区的作用更为关键。本工具默认设置边距为 4，我们建议在大多数情况下保留这一默认值，不要将边距设置为 0 或 1。

3. 背景干扰：如果二维码打印在有图案、有纹理、或渐变色的背景上，扫码器可能难以准确识别模块边界。建议二维码的直接背景保持纯色（白色或浅色），复杂的装饰图案应放在静区之外。

4. 打印质量：喷墨打印机的墨点扩散、激光打印机的低分辨率、以及印刷过程中的颜色偏移都可能破坏模块的精确边界。建议在最终印刷前使用打印机的最高分辨率测试，并在打印后的成品上实际扫描验证。

5. 反光与光照：玻璃表面的反光、塑料包装的眩光、以及强背光都会影响扫码。如果二维码需要贴在透明包装上，建议在二维码背面添加一个不透明的白色衬底。

6. 常见问题排查：

• 无法扫描：检查前景色与背景色对比度是否足够、Logo 是否遮挡了超过 20% 的面积、内容长度是否超过当前版本的容量、打印是否模糊。
• 部分手机可扫、部分不可扫：通常是颜色对比度或模块尺寸问题。老旧手机的摄像头和算法对低对比度的敏感度更高。尝试提高对比度或增大二维码物理尺寸。
• 中文扫码后显示乱码：极少数老旧或非主流扫码应用可能不支持 UTF-8 编码。确保扫码应用是系统原生相机（iOS 11+/Android 10+）、微信、支付宝或其他主流应用。
• 扫描后链接无法打开：检查 URL 是否完整（必须包含 http:// 或 https:// 前缀）、是否有特殊字符未被正确编码、是否超过了字符长度限制。

二维码看似简单，但当内容涉及敏感信息（如 WiFi 密码、个人联系方式、内部系统链接、机密项目编号）时，其隐私保护的重要性不可忽视。

为什么选择本地处理：本工具采用完全本地化的生成方案，所有输入的内容不会上传到任何服务器。从文本编码、Reed-Solomon 纠错计算、模块矩阵生成到最终的图像渲染——每一步都在你自己的浏览器中通过 JavaScript 完成。

本地处理的核心优势：

• 无网络依赖：即使完全断开互联网连接，工具依然可以正常使用。适合在飞机上、偏远地区、严格的内网环境中使用。
• 无数据记录：由于数据从未离开你的设备，不存在被存储、分析、转发或用于训练 AI 模型的可能性。
• 即时清除：关闭浏览器标签页后，所有输入内容和生成的二维码图像立即从内存中清除。
• 性能优势：本地计算速度远快于"上传-服务器生成-下载"的往返流程，尤其在大版本二维码或批量生成时差异更为明显。

敏感内容的安全建议：虽然本工具不上传数据，但仍需注意以下几点：

• 包含 WiFi 密码、访问凭证、个人身份信息等敏感内容时，建议在生成并下载二维码后关闭浏览器标签页，避免浏览器的自动恢复或自动填充功能意外泄露。
• 包含企业内部链接或项目信息时，建议在受控环境（如公司内网设备）中操作。
• 不建议在公共电脑或共享设备上生成敏感二维码，或在生成后确保清空剪贴板和下载记录。
• 下载的二维码图片文件本身可能保留在下载目录中，如果不再需要请及时删除。

静态二维码 vs 动态二维码：一个常见的误解是"二维码会过期"。实际上，静态二维码（本工具生成的类型）不会过期——它只是编码了文本或链接信息，只要原始链接有效，二维码就永远可以被扫描。动态二维码是通过第三方服务生成的中间跳转链接，服务提供商可以统计扫码次数、更新目标链接或在不更新二维码的情况下作废链接。动态二维码通常需要付费订阅服务，并且存在依赖第三方服务（如果服务停止，二维码将失效）、以及必须上传内容到服务器等隐私风险。对于大多数个人和中小企业场景，本地生成的静态二维码是更安全、更可靠的选择。

关于本工具隐私保护策略的更多细节，可参见我们的 隐私政策页面。