# 批量生成图片或文件二维码

目前不支持同时选中多个图片或文件，自动生成一批二维码。但我们提供批量模板功能，帮你提高生成效率。

【批量模板】就像一个模具，可以在模具中，按需求插入图片或文件组件。后续你可以为每个码上传图片或文件，生成一批二维码。

![批量模板功能示意图](https://blogcdnimg.clewm.net/2025/03/image-1741757682562_17417576836438.png)
该图展示批量生成人员证件照的三步操作流程：先添加可变内容组件，再填入文件名并上传文件夹，最后系统自动匹配名称生成带图片/子码的证件。

目前已支持在新建或复用模板新增子码时，通过在线表格路径，批量导入图片和文件；或在保存批量模板后，通过上传Excel方式批量导入图片和文件；后续会支持已有子码批量修改图片和文件。

## 1. 在模板中添加图片/文件可变内容

在 [模板库](https://cli.im/template "模板库")，全部功能筛选「批量生码」，选择空白新建批量模板。或者也可直接访问 [批量模板编辑器](https://console.cli.im/nedit/53124761?type=placeholder&categoryId=-11&action=add&create_from=95&pageFrom=tplLibMine&codeId=53124761&package_id=1570&tplId=39109&scene_log=eyJzaWQiOjEzLCJpaWQiOjAsInRwbF90eXBlIjoiMSIsImJ0bl90eXBlIjoiMSIsImNvZGVfaWQiOiI1MzEyNDc2MSIsImNmIjozLCJiYXRjaHR5cGUiOjAsImF0aW1lIjoxNzI3NTcyMjE5LCJ0YWdfa2V5IjoiIiwic2NlbmVfdmVyc2lvbiI6InRwbF9jcmVhdGUiLCJtYXN0ZXJfaWQiOjAsInB1YmxpY2tleSI6ImIyNGJkYzQ2MDA3MjFlMzFhYmIwMmIwZjc1M2QwYWEwIn0%3D "查看模板编辑器") 进行新建。

编辑批量模板时，添加图片、文件等可变内容组件。[查看详细模板编辑教程](/help/bulk-qr-code/bulk-dynamic-qr-code/template-design/edit-bulk-template "查看详细模板编辑教程")

![文件上传界面](https://blogcdnimg.clewm.net/2025/03/image-1741756260215_17417562625098.png)
该图展示在模板编辑中添加可变内容的组件选择面板，含文本与多媒体（图片、文件等）两类可变内容选项。

保存模板后，批量生码时，需要在图片/文件可变内容列，填入待上传的文件名称。上传文件夹后，系统会自动根据文件名做匹配，插入到对应子码中。

若图片或文件名称和某一列可变内容数据一致，可选择将“xx可变内容”列的数据自动填入图片可变内容列，降低填入操作成本。

![文件匹配界面](https://blogcdnimg.clewm.net/2025/03/image-1741756412600_17417564132915.png)
该图展示“可变内容-图片”模块的配置界面，说明如何设置多张图片轮播、手机端编辑权限及批量上传图片时自动填充可变内容数据。

## 2. 批量上传图片、文件

### 方式一：在线表格路径批量上传

支持在新建或复用模板新增子码时，通过在线表格路径，批量导入图片和文件。

大致步骤：

第一步：先将本地需要上传的图片、文件分别整理到文件夹中；
第二步：在「在线表格」对应的图片、文件列，填入需要上传的图片/文件名称；若文件名称和某列可变内容数据一致时，可选择将该列的数据自动填入文件可变内容列
第三步：点击「批量上传」，上传文件夹；
第四步：点击生成二维码，即可批量生成带图片、文件的一批子码；

以人员场景，批量上传人员照片为示例：只需在图片/文件可变内容列，填入文件名称，上传文件夹后，系统会自动根据文件名匹配，将文件填入对应子码。

体验示例

示例批量模板：[人员信息模板](https://cli.im/share/0bot0pz "人员信息模板")
示例Excel： [示例Excel](https://blogcdnimg.clewm.net/2024/09/批量上传图片或文件_示例excel_17270706377939.xlsx "批量上传图片或文件_示例excel")
示例文件包：[示例文件包](https://blogcdnimg.clewm.net/2024/09/示例文件包_17270706865897.zip "示例文件包")

#### 具体教程

**2.1 填写生码数据，将图片或文件名称，填入在线表格对应列中**

填写注意事项：
- 文件名和在线表格列填入的名称必须一致；填入的名称不需要包含文件后缀；建议使用编号等唯一标识的内容作为文件名称；
- 支持批量复制内容到对应列，名称不能重名；
- 子码的一个可变内容组件里，支持上传多个图片或文件内容，文件名称用 ; 符号间隔。例：资质文件可变字段，员工A需上传2个文件，在单元格中输入：安全证书;参保证明
- 支持图片(jpg、png)，文件(pdf、doc、xlsx、ppt )等多种格式。[文件格式](/help/faq/file-qr-code#a1 "文件格式")

![填写生码数据示例](https://blogcdnimg.clewm.net/2024/10/image-1728975760220_17289757624212.png)
展示产品图片文件名与表格数据的对应关系，说明如何将文件名（不含后缀）填入“产品图片”列以建立关联。

若图片或文件名称和某一列可变内容数据一致时，可选择将“xx可变内容”列的数据自动填入图片可变内容列，降低填入操作成本

![自动填入图片可变内容](https://blogcdnimg.clewm.net/2025/03/image-1741756757286_17417567579235.png)
此图为批量上传图片时的“填充设置”弹窗，用于将“姓名”等文本变量自动填入对应列，实现数据与图片的智能匹配。

**2.2 上传本地文件夹**

按在对应可变内容列头，点击「批量上传」，选择本地对应的图片或文件上传即可。文件上传后，系统会根据名称规则，自动将图片或文件填入子码对应位置。

![批量上传本地文件夹](https://blogcdnimg.clewm.net/2024/10/image-1728975909052_17289759097625.png)
展示产品列表中“批量上传”功能的操作指引，箭头与文字提示用户点击G列“批量上传”按钮进行图片批量导入。

上传文件后提示有未匹配内容

通常有以下几种情况：
- 名称匹配异常：在线表格中填写的名称与上传的文件名称不一致
常见问题：名称中多了空格、有错别字、文件后缀不一致、带有-\*等特色符号等
- 数量匹配异常：在线表格中填入的名称数量和上传的文件数量有差异。
例如：表格中有18行数据，上传的文件只有15个，数量不一致
- 文件过大，或数量过多：图片单张大小上限30MB，每个单元格最多上传20个图片；文件单个大小上限500MB，每个单元格最多上传50个文件。
- 其他：可能是由于网络波动、服务器波动导致某个文件上传失败，可以重新上传文件。

在列头筛选 “未匹配” ，即可查看未匹配的内容。可修改文件名称后继续批量上传，或者单个上传图片或文件。

![文件未匹配提示](https://blogcdnimg.clewm.net/2024/10/image-1728976028198_17289760299247.png)
展示产品列表的后台管理界面，重点说明“批量上传”列可下拉筛选“未匹配”内容，用于批量处理产品图片关联。

文件上传，匹配成功后，会自动填入对应位置。点击生成二维码，即可自动批量生成多个包含图片或文件的子码。

![文件上传成功界面](https://blogcdnimg.clewm.net/2024/10/image-1728976140195_17289761410433.png)
展示产品信息表格中“批量上传”功能区域，标注匹配成功的图片与文件将自动填入对应单元格，用于指导用户操作。

### 方式二：上传excel路径批量上传

上传Excel方式目前仅支持在保存批量模板后，通过上传excel数据和文件包方式实现。

需按照下方教程操作，系统会通过名称匹配，自动将图片填入到对应位置。

大致步骤：

第一步：先将本地需要上传的图片、文件分别整理到文件夹中；
第二步：将图片、文件名称，填入Excel表格对应的图片或文件可变内容列中；
第三步：上传填好数据的Excel表格；
第四步：上传整理好的文件夹；
第五步：点击批量生码，即可批量生成带图片、文件的一批子码；

体验示例

示例批量模板：[人员信息模板](https://cli.im/share/PiryTbR "人员信息模板")
示例Excel： [示例Excel](https://blogcdnimg.clewm.net/2024/10/示例excel文件_17294910390221.xlsx "批量上传图片或文件_示例excel")
示例文件包：[示例文件包](https://blogcdnimg.clewm.net/2024/10/示例文件包-批量上传_17294910685357.zip "示例文件包")

#### 具体教程

**2.1 准备数据，将图片或文件名称，填入Excel对应列中**

1) 在Excel中填入需要生码的数据，一行数据对生成一个子码。[Excel填写注意事项](/help/bulk-qr-code/bulk-dynamic-qr-code/generate-with-template/excel-bulk-qr-code-generation#faq "excel填写注意事项")

2)在Excel每行数据对应的图片或文件可变内容单元格中，填入对应的图片或文件名称。也支持上传excel后选择某一列可变内容数据自动填入图片或文件可变内容列。

[如何批量填入文件名称](/help/bulk-qr-code/bulk-dynamic-qr-code/template-design/variable-content/qr-code-batch#tianru "批量填入文件名称方法")

填写注意事项：
- 文件名和Excel填入的名称必须一致，否则无法匹配。不需要包含文件后缀，建议使用编号等唯一标识的内容作为文件名称；
- 支持图片(jpg、png)，文件(pdf、doc、xlsx、ppt )等多种格式。[文件格式](/help/faq/file-qr-code#a1 "文件格式")
- 子码的一个可变内容组件里，支持上传多个图片或文件，文件名称用 ; 符号间隔。例：资质文件可变字段，员工A需上传2个文件，在单元格中输入：安全证书;参保证明
- 一次性最多只能上传包含500个图片/文件的文件夹；若需要上传超过500个的文件，可以通过在线表格分批上传。

![Excel数据填写示例](https://blogcdnimg.clewm.net/2024/10/image-1729649575861_17296495764378.png)
展示如何将产品图片文件名（如IMT-M3.png）对应填入表格“产品图片”列，实现文件名与产品参数的关联映射。

**2.2 上传Excel表格**

准备好Excel数据后，在批量模板详情页或列表页，点击上传Excel生码。在弹窗上点击上传Excel表。

![上传Excel表格界面](https://blogcdnimg.clewm.net/2024/07/image-1722230984668_17222309853474.png)
Excel数据批量导入操作指引，展示上传模板、选择文件及填入图片/文件名的步骤流程。

**2.3 上传本地的图片、文件**

上传Excel匹配列后，会进入图片文件上传界面。批量模板中包含几个图片、文件可变内容字段，就会出现几个上传入口。按需求在对应的可变内容框中，点击上传文件夹，选择本地对应的图片或文件上传即可。

文件上传，匹配成功后，点击批量生成，即可自动批量生成多个包含图片或文件的子码。系统会根据名称规则，自动将图片或文件填入子码对应位置。

![文件上传界面](https://blogcdnimg.clewm.net/2024/10/image-1729649633676_17296496351301.png)
上传图片或文件步骤界面，引导用户将整理好的图片/文件通过文件夹上传，对应Excel模板中“产品图片”列的映射。

上传文件后提示匹配异常

提示匹配异常，通常有以下几种情况
- 名称匹配异常：Excel中填写的部分图片或文件名称，与上传的文件名称不一致
常见问题：Excel中填入的图片/文件名称没有带文件后缀、名称中多了空格、有错别字、文件后缀不一致、带有-\*等特色符号等
- 数量匹配异常：上传的Excel行数和上传的文件数量有差异。
例如：Excel表格中有18行数据，上传的文件只有15个，数量不一致
- 文件过大，或数量过多：图片单张大小上限30MB，每个单元格最多上传20个图片；文件单个大小上限500MB，每个单元格最多上传50个文件。
- 其他：可能是由于网络波动、服务器波动导致某个文件上传失败，可以重新上传文件。

出现异常提示，可以点击查看异常列表，查看具体不匹配的文件，进行针对性的修改后再重新上传文件。

![匹配异常提示界面](https://blogcdnimg.clewm.net/2024/10/image-1729649660368_17296496616639.png)
Excel上传后提示3行内容未匹配，界面列出不匹配文件名及常见异常问题，并提供查看异常列表与重新上传选项。

## 3. 单个上传或修改图片、文件

上传文件：可在「在线表格」或者「子码列表页」点击上传，一个个上传多媒体文件。也可以通过单个生码方式，上传图片或文件，生成子码。

修改文件：可子码列表页点击批量修改，进入在线表格修改图片或文件。或者通过子码预览弹窗，编辑单个子码修改文件。

![上传文件界面](https://blogcdnimg.clewm.net/2025/03/image-1741756913420_17417569140640.png)
设备巡检子码列表页，展示6个巡检任务及对应灭火器信息，右侧虚线框标注“上传本地图片”操作区域。

#### 进阶教程：如何批量填入文件名称

**方式一：若图片/文件名称和表中某一列的数据相同，可直接在表格中复制粘贴列**

可以直接在Excel或在线表格的对应图片、文件可变内容列，粘贴整列内容。

**方式二：将需要上传的图片或文件全选复制，新建txt，粘贴到txt中，即可批量获取文件名称。**

1、打开文件夹，多选需要上传的图片/文件，鼠标点击右键复制拷贝
2、本地新建一个txt文件，鼠标右键粘贴，即可获取到文件名称
3、将文件名称填入excel对应的单元格中

![批量修改文件界面](https://blogcdnimg.clewm.net/2024/07/image-1721872136810_17218721381914.png)
展示Excel中“人员照片”文件夹内图片的批量选中与右键复制操作步骤，含新建txt文件粘贴的后续动作指引。

后续会支持已有子码批量修改图片和文件。有任何批量上传图片/文件功能相关的使用问题或需求建议，都可以前往社区反馈，我们会持续迭代。[前往社区反馈](https://cli.im/community/tab/mixflow "前往社区")
