如何设置条形码生成器并生成条形码图片

先了解输入与选项

条形码生成器可根据输入内容生成条形码 PNG 图片数据，并允许你选择条形码格式、图像尺寸以及是否显示文字。它适合把商品编号、内部编码或其他需要编码的文本转换为可保存或继续处理的条形码图像。默认格式为 Code 128；如果不填写数据，工具仍会返回结果，但不会生成图片。

操作步骤：设置并生成条形码

1. 在数据输入区域填写要编码的内容。若使用默认设置，格式会采用 Code 128；需要其他格式时，在格式选项中选择相应格式。格式名称会统一处理大小写、连字符、空格以及部分下划线写法，但并不表示每一种格式都受支持。

2. 按需要设置宽度、高度和文字显示选项。对于非空数据，宽度会被规范到 100 至 2000 之间，高度会被规范到 40 至 600 之间；无法转换为整数的宽度或高度会分别回退到 400 和 100。文字显示选项默认开启，可按需要关闭。

3. 点击生成控件并查看返回结果。如果输入的是数字格式，工具会在格式已识别且相关条码组件可用时去除非数字字符，再按该格式所需的位数处理输入；适用时，条码库会提供校验位。输入数字不足时不会返回图片。

4. 生成成功后，使用返回的 Base64 编码 PNG 图像数据进行预览或后续处理。若结果带有错误提示，请先检查数据是否为空、格式是否受支持，以及数字格式的输入是否满足所需位数。组件不可用或生成过程发生异常时，也可能返回失败结果。

如何判断生成结果

成功结果应包含可作为 PNG 图像数据使用的 Base64 编码内容。宽度和高度是经过规范化的设置，并不保证生成 PNG 的实际像素尺寸与填写的数值完全一致，因此需要精确版式时应以生成后的图像为准。

空数据会得到带错误提示的成功结果，但不会有图片。已识别的数字格式若在清理非数字字符后仍未达到所需位数，也会得到带错误提示的成功结果而不是图像；未被条码库支持的格式同样不会生成图片。若条码组件不可用或生成时发生异常，返回结果还可能被标记为失败。

使用示例

你要把内部编号“CN-2025-001”制作成带文字的 Code 128 条形码 PNG 数据。

在数据区域输入“CN-2025-001”，选择 Code 128，设置宽度 800、高度 160，保持文字显示开启，然后执行生成。

结果应呈现成功状态，并包含可作为 PNG 图像使用的 Base64 编码数据；实际像素尺寸不保证恰好为设置值。

使用限制

• 并非每种格式都能生成图片；格式不受支持、条码组件不可用或生成发生异常时可能出现错误结果，且尺寸设置不保证等于 PNG 的实际像素尺寸。

常见错误

• 选择数字格式后只填写了不足所需位数的内容。请确认格式要求，并在清理非数字字符后提供足够的数字；否则结果会带错误提示且不包含图片。

常见问题

不输入数据也能生成条形码吗？

可以，但不填写数据时只会返回带错误提示的成功结果，不会生成图片。

设置的宽度和高度就是图片的实际尺寸吗？

不一定。宽度会规范到 100 至 2000，高度会规范到 40 至 600，但生成 PNG 的实际像素尺寸不保证与设置值完全一致。

数字格式的条形码可以直接使用带字母或符号的输入吗？

只有在格式已识别、条码组件可用且输入达到该数字格式所需位数时，工具才会继续生成；非数字字符会先被移除，位数不足时不会返回图片。