图像

二维码生成器指南:静态链接、字节限制与清晰导出

·

二维码生成器在浏览器中把当前文本或链接制成静态二维码。修改输入或纠错级别时,预览随之更新。您可以下载模块边长为整数像素的白底黑色 PNG,或可缩放的 SVG;两种格式都保留四模块宽的空白边距。

图片中的编码内容固定,但链接目标仍可能被外部更改或失效。输入单位与 UTF-8 字节容量不同,PNG 尺寸选项也是目标值。纠错能力和成功显示的预览都不能保证扫描距离、目标安全性或每个扫描器的解读完全相同。

二维码生成器

使用实时预览创建二维码

二维码生成器初始时,“文本或链接”为空,“纠错级别”为中,PNG 尺寸目标为 1024 像素。输入或粘贴编码内容后,预览自动出现。编辑文本或切换纠错级别会重新计算二维码;没有单独的生成按钮。

下载前检查当前文本。如果是链接,请另行核对完整目标地址,包括协议、路径和查询参数。预览表明文本在所选级别下能被此编码器容纳,却不能证明网站存在、内容安全或手机能够成功打开它。

  • 输入想让二维码包含的文本或链接。
  • 选择纠错级别和 PNG 目标尺寸,检查预览及错误。
  • 下载所需格式,用目标扫描器测试实际文件或印刷品。

编码内容是文本,目标地址并未得到验证

编码器直接使用文本框的当前值,不去除首尾空白、不缩短 URL,也不访问目标地址。因此,空格、换行、大小写和标点都可能有影响。缺少的协议或意外的末尾字符仍属于输入内容。工作区不会把每个字符串变成有效网址。

扫描器决定如何显示或处理解码后的文本。通用编码器可以容纳普通文本或已按某种格式准备的内容,但此工作区没有 Wi-Fi、联系人卡片、付款或邮件的专用填写向导。成功预览不等于验证了这些外部格式。

MDN:TextEncoder 与 UTF-8 字节

固定编码内容与链接内容变化要分开看

下载的二维码图片包含固定编码内容。更改这份内容需要生成新图片。ToolMellow 不加入中间扫描跳转、到期计时器或可编辑目标的管理面板。历史上的“永久二维码生成器”之类措辞只是在描述静态格式,不保证外部服务的寿命。

即使 https://example.com/menu 这样的地址不变,以后提供的内容也可能不同,所有者还可能更改其后的跳转。URL 也可能失效、要求身份验证,或无法被某个扫描器访问。选择自己能维护的地址,更改后重新测试;二维码图片本身不能维持目标在线。

可见字符、输入单位与编码字节不同

文本框将用户输入限制为 3000 个 UTF-16 代码单元。编码器另行把格式正确的 JavaScript 字符串转成 UTF-8 字节。可见字符没有统一的成本:a 占一个 UTF-8 字节,é 占两个,世 占三个,😀 占四个。这个表情也占两个 UTF-16 代码单元。

因此,文本即使符合输入框限制,也可能超出所选二维码的字节容量。编码器会拒绝未配对的 Unicode 代理项,而不是悄悄替换。应缩短编码内容,不要认为可见字符数量就能衡量字节长度。这些限制针对框中的文本,不是上传文件;此工作区没有文件输入流程。

MDN:TextEncoder 与 UTF-8 字节MDN:maxlength 与 UTF-16 输入单位MDN:检测未配对的 Unicode 代理项

容量有限,并取决于所选纠错级别

本实现始终采用单个 UTF-8 字节模式数据段。它不把数字优化为数字模式,不使用字母数字或汉字模式数据段,也不输出 ECI 数据段。因此,其他模式的通用二维码容量数字不能代表本工具。下表列出编码器在版本 40 的最大字节载荷;较低版本容量更小。

默认级别是 M,所以 2953 字节并非默认上限。例如,重复 984 次 世 会占 2952 字节,在 L 级能够容纳;重复 985 次则占 2955 字节,超过该上限。切换级别可能同时改变容量与所选版本,输入框的独立限制仍然适用。

容量有限,并取决于所选纠错级别
级别版本40的最大 UTF-8 字节数控件选项的含义
L2953低纠错级别
M2331中级;工作区默认值
Q1663较高纠错级别
H1273高纠错级别

DENSO WAVE:二维码版本与容量MDN:TextEncoder 与 UTF-8 字节

版本与模块数量帮助解释二维码密度

编码器根据内容和所选级别,在普通二维码版本 1 至 40 中选择能容纳内容的最小版本。每边模块数为 17 + 4 * version:版本 1 每边有 21 个模块,版本 40 有 177 个。显示的版本和模块数不包含空白边距。

增加字节或更改纠错级别可能提高版本,但每次变化都不一定跨越容量边界。版本不变时,每边模块数也不变,即使图案已经改变。在固定物理尺寸下,更多模块通常意味着每个方块更小;仅凭预览不能测得可靠扫描距离。

DENSO WAVE:二维码版本与容量DENSO WAVE:空白边距与模块尺寸

恢复比例不等于可以遮盖的图片面积

控件分别为 L、M、Q、H 标注约 7%、15%、25%、30% 的恢复能力。DENSO WAVE 用总码字说明纠错恢复,每个码字包含八位。这些标注并未指出可安全遮挡、擦除或用标志替换的可见图片面积比例。

恢复效果取决于损坏了哪些信息,以及扫描器能否定位和解读二维码。同样的内容采用更高级别时可能需要更高版本,而较低级别也不保证更远扫描距离。保持定位图形与空白边距完整,并测试实际输出。本工具不测试损坏后的二维码,也不认证标志叠加安全。

DENSO WAVE:纠错与码字恢复DENSO WAVE:空白边距与模块尺寸

PNG 尺寸是目标值,下载边长可能更小

PNG 尺寸提供 256、512、1024、2048 像素目标值。渲染时每边保留四模块宽的边距,每个模块分配整数像素。对这些选项,正方形边长为 (size + 8) * floor(target / (size + 8))。工具在不透明白底上绘制黑色方块,不以小数像素拉伸模块边缘来凑满目标尺寸。

版本 1 的完整宽度为 29 个模块:二维码 21 个,加两边边距共八个。所以下表示例适用于 M 级的 a 等短内容。版本 40 的完整宽度为 185 个模块,1024 目标值会得到 925 像素。PNG 尺寸不会增加容量或更改编码字节。

PNG 尺寸是目标值,下载边长可能更小
版本1的 PNG 目标值每模块的整数像素数导出正方形边长
2568232 像素
51217493 像素
1024351015 像素
2048702030 像素

DENSO WAVE:空白边距与模块尺寸MDN:Canvas.toBlob、PNG 导出与 null 结果

SVG 保留矢量几何与四模块空白边距

“下载 SVG”会生成固定的白底黑色矢量二维码,viewBox 覆盖二维码及四模块宽的空白边距。文件没有固定像素宽度或高度。放入版面后缩放会改变显示或印刷尺寸,同时保留矢量几何;PNG 尺寸选项不设置 SVG 的导出尺寸。

在文档中放置二维码时,请保留周围白色边距。裁去边距、覆盖其他图形或在旁边放相似的深色标记,都可能增加识读难度。矢量格式不能保证任意小的印刷品、模糊截图或每个扫描器都能解码。确定完整放置尺寸,再测试导出或印刷结果。

DENSO WAVE:空白边距与模块尺寸

输入错误替换预览,清空仍保留选项

文本超出容量或 Unicode 格式错误时,错误提示会替代预览和下载操作。输入框保留当前文本;应用不会截成另一份有效内容,也不会继续提供旧图片。缩短文本或修改纠错级别会重新计算结果。仅改变 PNG 尺寸不能消除字节容量错误。

有有效预览时,“清空”可用。它清除文本、移除当前二维码并显示已清空提示,同时保留纠错级别和 PNG 目标尺寸。文本编辑会清除提示;级别和尺寸变化不会主动清除提示。输入无效时,请直接编辑或删除文本。重新加载恢复为空输入、M 级和 1024 目标值。

MDN:检测未配对的 Unicode 代理项MDN:maxlength 与 UTF-16 输入单位

本地生成不会加密二维码中的数据

组件在浏览器中计算二维码并创建导出数据,不发出携带输入文本的生成请求。二维码中不添加 ToolMellow 扫描跳转或扫描统计面板。一般网站托管与分析,以及访问编码目标时产生的请求,与这一步本地生成是分开的。

二维码图片是扫描器可能揭示的数据表示。下载、印刷或分享会在工作区之外产生副本,图片中的链接也可能通向有自身跟踪或访问规则的服务。纠错提高对部分损坏的耐受性,却不是加密、身份认证或防止他人读取内容的保护。

下载是外部副本,PNG 和 SVG 可互为替代

两种导出文件名为 toolmellow-qr-code.png 和 toolmellow-qr-code.svg。PNG 通过本地画布绘制,SVG 根据当前模块几何构建。如果浏览器无法取得画布绘图上下文,工作区会显示建议改用 SVG 的提示。如果 PNG 转换未返回 Blob,则不会下载文件,也不会出现新的失败提示。

如果没有文件出现,请尝试 SVG 并检查浏览器下载处理。共享下载辅助函数在 60 秒后撤销临时对象 URL;这只是释放浏览器中的 URL,不会删除已保存图片。清空与重新加载都不会擦除已经下载或放入其他文档的副本。

MDN:Canvas.toBlob、PNG 导出与 null 结果MDN:File API、Blob 对象与对象 URLW3C File API:撤销对象 URL

在目标条件下测试实际输出

应核对解码内容,不只是看扫描器是否发现方形图案。链接需要在目标设备和网络上检查地址及目标页面。多种文字或表情也应核对解码文本:此编码器使用没有 ECI 标记的 UTF-8 字节模式,扫描器如何解读需要实际测试。

使用最终放置尺寸下的实际文件。保留对比度和空白边距,避免模糊或意外重采样;分发印刷品前测试样张。密集图案、小模块、光线、反光、损坏及扫描器都可能影响结果。任何 PNG 目标值、纠错级别或矢量导出都不能确立通用的物理尺寸或扫描距离。

DENSO WAVE:空白边距与模块尺寸DENSO WAVE:纠错与码字恢复MDN:TextEncoder 与 UTF-8 字节

明确工作区提供的流程

这是一次处理一份静态文本的编码器,提供纠错级别、PNG 目标尺寸以及 PNG/SVG 下载。工作区没有批量生成、图片扫描器、自定义颜色、标志编辑器、URL 缩短器、可编辑动态跳转、扫描统计、账户历史或托管文件上传服务。

库辅助函数可能接受页面未公开的额外参数;这些参数不是工作区功能。已经格式化的内容可能可以编码,但这里没有 Wi-Fi 凭据、联系人卡片或付款指令的专用构建与验证器。先使用能验证所需格式的流程,再测试解码结果,不要认为任意成功预览都验证了内容含义。

针对失败的环节排错

没有预览、PNG 比预期小、扫描器解码出错和链接页面失效,是不同问题。先检查可见文本、所选级别和当前错误,再检查导出文件及版面位置,随后检查实际扫描器和目标。改动无关控件不能修复所有环节。

下表把常见现象与工作区中可做的检查对应起来。它是判断辅助,不保证每个设备、浏览器或印刷样本都能正常使用。保留预期编码内容,方便对照扫描器实际解出的结果。

针对失败的环节排错
现象需要检查的环节下一步操作
文本过长错误所选级别下的 UTF-8 字节容量缩短内容或改用另一个合适级别;PNG 目标值无关。
PNG 小于所选目标值整数模块的栅格几何使用实际导出尺寸;需要时选择更大目标值或 SVG。
无法解码或显示错误文本版面放置与二维码/扫描器解读保留边距、适当放大,并测试原文件和预期内容。
扫描器识别了二维码,但页面无法打开外部目标或访问权限检查解码 URL、可用性、跳转、身份验证和网络。

DENSO WAVE:空白边距与模块尺寸DENSO WAVE:纠错与码字恢复

URL 编码与解码器可帮助检查已编码的组成部分,但盲目编码整个地址或重复编码可能改变含义。文本清理器可以在粘贴前主动去除多余字符;请核对这些修改,因为二维码工作区本身不会替您去空白或规范化文本。

图片尺寸调整器可帮助把 PNG 放入版面,但重采样会改变像素,并可能模糊模块边缘。保留空白边距,调整后重新检查。矢量版面应保留原 SVG 几何并选合适放置尺寸。这些是独立工具流程;二维码页不会自动上传或把内容交给它们。

常见问题

这些二维码会过期吗?

ToolMellow 不为静态图片添加到期计时器。编码内容固定,但外部 URL 可能失效、要求访问权限或指向变化后的内容。永久/静态措辞不保证目标寿命。

不重新印刷能更改目标吗?

更改编码 URL 需要新图片。如果您控制未改变的 URL,可以在外部更改它提供的内容或跳转。本工作区不提供托管动态二维码管理服务。

预览会检查 URL 能否访问吗?

不会。只要当前文本符合所选级别容量,就进行编码。它不会访问地址,也不验证安全性、可用性或外部内容格式。请另行检查解码地址及目标。

能容纳多少文本?

在版本 40,UTF-8 字节模式上限为 L 级 2953、M 级 2331、Q 级 1663、H 级 1273。默认是 M。输入框还限制为 3000 个 UTF-16 代码单元;两种限制都不是通用可见字符数。

空格、换行和 Unicode 会怎样处理?

编码器不去除文本框当前值的首尾空白。格式正确的文本写成 UTF-8 字节,未配对代理项被拒绝,不输出 ECI 数据段。请用目标扫描器测试非 ASCII 解码文本,不要假定所有扫描器的解读一致。

更高级别总会让二维码更密集吗?

不会。同样的字节可能因级别变化而需要更高版本,但模块数量只有在版本变化时才改变。控件的近似恢复标注描述纠错概念,不保证扫描距离。

可以用标志遮住30%的二维码吗?

30% 是 H 控件的近似恢复标注,不是可以安全遮盖的图片面积比例。DENSO WAVE 以码字讨论恢复;损坏位置与识别过程也有影响。本工作区没有标志工具或叠加验证。

为什么1024像素选项不是精确的1024像素导出?

渲染器为每模块保留整数像素,并包含空白边距。版本 1 的完整宽度有 29 个模块,所以 1024 目标值会得到 1015 像素。其他版本的取整尺寸不同。

PNG 尺寸选项会改变 SVG 吗?

不会。它影响之后的 PNG 栅格导出。SVG 具有可缩放 viewBox 几何与四模块空白边距;没有为 SVG 选定固定导出像素宽度。

清空会删除什么?

有效预览下,清空移除文本和预览,但保留纠错级别与 PNG 目标值。它不会擦除导出文件。输入无效、下载和清空操作不显示时,请直接编辑或删除文本。

为什么 PNG 没有下载?

缺少画布上下文时,会提示使用 SVG。PNG Blob 为 null 时不产生文件或新提示。请尝试 SVG,并检查浏览器下载处理;本指南不证明每个浏览器都兼容。

文本与扫描记录会发送给 ToolMellow 吗?

生成在浏览器内进行,没有包含输入内容的请求,也不插入 ToolMellow 扫描跳转。一般网站托管/分析,以及访问目标时的请求,属于其他环节。分享的二维码图片本身也可能揭示其内容。

能生成动态码、添加标志或处理批量吗?

工作区没有这些功能。它提供单份静态文本、纠错选项、PNG 目标值和 PNG/SVG 下载。可编码通用格式文本不等于提供 Wi-Fi、联系人或付款格式的专用验证。

分发前应该测试什么?

在预期尺寸下,用有代表性的扫描器测试实际导出文件或印刷品。核对解码文本、完整 URL 和目标访问,保留空白边距与对比度;重采样或目标发生外部变化后重新测试。

来源与延伸阅读

动手试试。

相关指南