批量制作二维码：把表格变成可维护的资产

准备数据、映射字段、识别失败项、整理导出文件。批量创建不只是一次生成很多码，更要避免后续找不到对应关系。

当二维码数量从几张变成几十张，逐个复制粘贴会变得难以复核。批量创建可以节省重复操作，但也会放大错误：一列地址映射错了，错误就可能同时出现在整批物料里。可靠的流程应把数据检查放在前面，把逐项对应关系一直保留到交付之后。

以下使用一组虚构产品资料，说明怎样组织 CSV、批次和导出清单。字段名称是本文建议的数据约定，实际导入时应根据你账户里的导入模板进行映射。

01　先把“每一行代表什么”说清楚

一行应当代表一个明确的二维码任务，例如某个产品的中文说明入口，而不是一个含多个链接的混合单元格。给这行记录一个稳定标识，名称负责让人看懂，标识负责让系统和文件对应。

名称可以修改，也可能重复，所以不适合作为唯一身份。文件夹用于整理现有资产；批次用于记录一次生成任务。把一个二维码从“新品”文件夹移到“常售”文件夹，不应让你丢失它原来属于哪次导入的线索。

02　让 CSV 保持可预测

使用 UTF-8 保存包含中文的文件，检查导入预览中是否出现乱码。对于产品编号的前导零，不要依赖电子表格自动推断类型；把编号当文本管理，并在导出后再核对。每列最好只有一种用途，备注不要偷偷塞进地址列。

CSV 中含逗号、换行或双引号的字段需要正确引用，字段内部的双引号也要转义。不要用简单的字符串逗号拆分代替正规的解析。RFC 4180 对这种常见交换格式给出了基本约定，可作为检查依据。[1]

external_id,name,url
manual-001-zh,手冲壶中文说明,https://qrhub.win/?demo=manual-001-zh
manual-002-zh,研磨器中文说明,https://qrhub.win/?demo=manual-002-zh
manual-003-en,咖啡秤英文说明,https://qrhub.win/?demo=manual-003-en

上面的地址只用于展示字段结构，不代表这些产品页面已经上线。正式导入前，应替换为真实公开地址，并逐项核对内容。

03　字段映射之后，先抽样再全量

在映射界面检查列标题与实际内容，而不是只看第一个单元格。抽样可以覆盖第一行、最后一行、带中文的名称、最长地址和特殊字符。如果某列名字叫 Link，但实际装的是图片预览地址，就应该在生成前修正。

校验至少区分两类问题：结构问题，例如必填为空或地址格式错误；业务问题，例如同一产品出现两条不同去向，或者目标页面需要登录。前者可以自动检查，后者通常需要负责人确认。导入成功不代表业务内容已经正确。

先生成少量样本，用手机验证，并让实际使用物料的人确认。如果这一步还没有完成，不要为了赶进度就直接下发整批印刷文件。

04　把部分失败作为正常分支设计

假设本次有 100 条任务，97 条成功、3 条失败，这只是一个演示场景。理想的结果页应该保留所有行的状态和失败原因，让你只修复那 3 条。不要简单重新导入整个文件，否则可能得到重复记录、重复导出和难以对账的编号。

在系统实现上，批次身份和每行身份可以帮助限制重复创建；在人工流程上，应保留失败清单、重试时间和最终结果。对于仍在处理中或状态不明的任务，先查询结果，再决定是否重试，而不是把“没有立即看到成功提示”当成失败。

05　导出的是一份可追溯交付物

建议压缩包同时包含图片和内容清单。文件名可以使用稳定编号加简短名称，例如 manual-001-zh.svg。清单记录编码内容、目标地址、二维码 ID、批次 ID 和导出时间，让设计师、运营人员与开发人员都能核对。

从不可信输入导出供电子表格打开的 CSV，还要考虑公式注入风险。以 = 等字符开头的内容可能被软件当作公式；处理方式需针对目标软件验证，不能把“包上双引号”视作通用安全保证。[2]

06　让下一次修改更容易

批量创建完成之后，记录谁负责这批内容、何时复查和何时归档。修改单个二维码时保留批次关系；删除或停用时写明对历史统计的影响。一个清楚的批次，应当既能看整体，又能打开其中任意一行追溯原始任务。

你最终得到的不应只是一个装满图片的文件夹，而是一组有身份、有用途、有维护记录的连接资产。这样数量增长以后，管理成本才不会随之失控。

关联文章