批量生成图片或文件二维码
草料目前不支持「一次选中多个图片或文件自动生成一批二维码」。如需为一批码关联独立的图片或文件，建议使用批量模板功能——在模板中预埋图片/文件可变内容组件，再通过在线表格或 Excel 批量导入文件，一次生成一批带图片或文件的子码。
适用场景：人员证件、产品资料、资产档案、安装记录等需要为每个码绑定独立媒体文件的场景。
开始前请确认：
- 已了解 批量模板的基本用法
- 本地已准备好需要上传的图片或文件，并整理到文件夹中
支持格式：图片支持 jpg、png；文件支持 pdf、doc、xlsx、ppt 等。查看完整文件格式
容量上限：图片单张 ≤ 30MB，单个单元格最多 20 张；文件单个 ≤ 500MB，单个单元格最多 50 个。
1. 在模板中添加图片/文件可变内容
入口：进入 模板库 → 全部功能筛选「批量生码」→ 选择空白新建批量模板，或复用已有模板。
在模板编辑器中，添加「图片」或「文件」类型的可变内容组件，保存模板。查看详细模板编辑教程
保存模板后进入批量生码时，需要在图片/文件可变内容列填入待上传的文件名。上传文件夹后，系统会自动按文件名匹配，将文件填入对应子码。
若文件名与某一列可变内容数据一致，可将该列数据自动填入图片/文件列，省去手动填写。
2. 批量上传图片、文件
草料提供两种批量上传路径，按使用习惯选择：
| 方式 | 适用阶段 | 入口 |
|---|---|---|
| 在线表格路径 | 新建模板或复用模板新增子码时 | 批量模板 → 批量生码 → 在线表格 |
| 上传 Excel 路径 | 已保存批量模板后导入数据 | 批量模板 → 上传 Excel 生码 |
方式一：在线表格路径批量上传
适用于新建或复用模板新增子码的场景。
操作步骤：
- 将本地待上传的图片/文件分别整理到文件夹中
- 在「在线表格」对应的图片、文件列，填入文件名
- 点击列头「批量上传」，选择本地对应的文件夹
- 系统按文件名自动匹配到对应子码，点击「生成二维码」完成批量生码
体验示例
2.1 填写文件名到在线表格对应列
注：
- 文件名与在线表格填入的名称必须一致，不需要包含后缀；建议使用编号等唯一标识作为文件名
- 支持批量复制整列内容，同一列中的名称不能重复
- 一个可变内容组件支持上传多个文件，文件名之间用
;分隔 例：资质文件字段员工 A 需上传 2 个文件，填入「安全证书;参保证明」
若文件名与某一列可变内容数据一致，可点击列头将该列数据自动填入图片/文件可变内容列。
2.2 上传本地文件夹
在对应可变内容列头点击「批量上传」，选择本地图片或文件夹上传。上传完成后，系统会按文件名自动填入到对应子码。
匹配成功后，文件会自动填入对应位置。点击生成二维码，即可批量生成多个包含图片或文件的子码。
方式二：上传 Excel 路径批量上传
适用于已保存批量模板后，通过上传 Excel 数据和文件包导入。
操作步骤：
- 将本地待上传的图片/文件分别整理到文件夹中
- 在 Excel 对应的图片/文件可变内容列，填入文件名
- 在批量模板详情页或列表页，点击「上传 Excel 生码」并上传 Excel 表
- 按每个图片/文件字段的上传入口，选择本地对应文件夹上传
- 文件匹配成功后，点击「批量生成」完成批量生码
体验示例
2.1 准备 Excel 数据
- 在 Excel 中填写生码数据，一行对应一个子码。查看 Excel 填写注意事项
- 在每行对应的图片/文件可变内容单元格中，填入文件名；上传 Excel 后也支持选择某一列数据自动填入。如何批量填入文件名
注：
- 文件名与 Excel 填入的名称必须一致，否则无法匹配；不需要包含文件后缀
- 一个可变内容支持上传多个文件，文件名之间用
;分隔- 单次最多上传 500 个文件的文件夹；超过 500 个建议通过在线表格分批上传
2.2 上传 Excel 表格
在批量模板详情页或列表页点击「上传 Excel 生码」，在弹窗中上传 Excel 表。
2.3 上传本地文件夹
Excel 上传成功后进入图片/文件上传界面。模板中有几个图片/文件可变内容字段，就会出现几个上传入口，按字段分别上传本地文件夹即可。
3. 单个上传或修改图片、文件
除批量上传外，也可以对单个子码逐个上传或修改：
- 上传文件：在「在线表格」或「子码列表页」点击上传；或通过单个生码方式，上传图片/文件后生成子码
- 修改文件：在子码列表页点击「批量修改」进入在线表格修改；或通过子码预览弹窗编辑单个子码
4. 验证是否成功
批量生码完成后，可以通过以下方式确认结果：
- 子码列表：检查生码后每个子码的图片/文件字段是否已填入，预览或扫码后能否正常查看对应的图片或文件
- 未匹配提示：若上传过程中出现「未匹配」提示，点击「查看异常列表」可定位具体未匹配的文件；在列头筛选「未匹配」，可查看仍未关联的行
5. 常见问题
5.1 上传后提示「未匹配」或「匹配异常」怎么办？
通常由以下原因引起：
- 名称不一致：表格中的文件名与实际文件名不一致。常见问题：多了空格、有错别字、文件后缀不一致、带
-*等特殊符号 - 数量不一致：表格行数与上传文件数对不上。例如表格 18 行、文件夹只有 15 个
- 文件过大或数量过多：图片单张超过 30MB 或单格超过 20 张；文件单个超过 500MB 或单格超过 50 个
- 网络波动：上传过程中因网络或服务器波动导致个别文件失败，重新上传即可
处理方式：在列头筛选「未匹配」，修改文件名后重新批量上传，或单个补传。
5.2 如何批量填入文件名到表格？
方式 A：复制粘贴已有列
若文件名与表格某列数据一致，直接在 Excel 或在线表格对应的图片/文件列粘贴整列内容即可。
方式 B：通过 txt 批量提取文件名
- 打开文件夹，多选需要上传的图片/文件，右键复制
- 本地新建一个 txt 文件，右键粘贴即可获得文件名列表
- 将文件名复制到 Excel 或在线表格对应单元格
注：已有子码批量修改图片和文件的能力正在规划中。如有使用问题或需求建议，欢迎前往 草料社区 反馈。