CSV 格式

批量创建读取的是一个简单的 CSV 文件：一行表头，然后每个二维码一行，包含名称和目标 URL。本页列出了你上传文件时 GetQR 检查的规则。

示例文件

bulk-qr-template.csv

name,url
Spring Menu,https://getqr.com/spring
Store #14,https://getqr.com/store-14
Table 7,example.com/menu?table=7
"Downtown, Main St",https://example.com/stores/downtown

你也可以在应用中下载这个起始文件：在 Add links 步骤中，点击 Download CSV template。

规则

部分	规则
文件	必须是 `.csv` 文件。不接受 Excel 和其他格式。
表头	第一行必须严格为 `name,url`：小写、按此顺序，且没有其他列。
数据行	最多 100 个非空行。空行会被忽略。
`name`	必填。将作为二维码名称。最多 40 个字符；更长的名称会被截断为 40 个字符。
`url`	必填。以 `http://` 或 `https://` 开头的网址。

URL 规则

如果省略协议，GetQR 会自动添加 https://。example.com/menu 会变为 https://example.com/menu。
地址必须包含带点的真实域名，例如 example.com。
不能包含空格、制表符或换行符。
仅支持网页链接。mailto:、ftp://、javascript: 和纯电子邮件地址会被拒绝。

重复名称

名称不必唯一。如果两行的名称相同（不区分大小写），GetQR 会为重复项编号：Menu、Menu 2、Menu 3。

逗号和引号

如果名称中包含逗号，请用双引号将其括起来，例如 "Downtown, Main St"。电子表格应用在另存为 CSV 时会自动处理。

在电子表格中创建文件

设置两列

在第一行中，在 A 列输入 name，在 B 列输入 url。

每个二维码添加一行

在每一行填写名称和链接，最多 100 行。

另存为 CSV

将工作表导出或另存为 CSV。在 Excel 中，选择 CSV UTF-8。在 Google Sheets 中，选择 File > Download > Comma-separated values。

以 UTF-8 格式保存，可以确保名称中的带重音字母和其他非英文字符（包括中文）完整保留。

验证错误

文件错误

这些错误会导致整个文件无法使用。请修正文件后重新上传。

消息	处理方法
Choose a CSV file. Other file types are not supported.	将文件保存为 `.csv`，而不是 `.xlsx` 或 `.numbers`。
The CSV header must be exactly name,url in that order.	将第一行设置为严格的 `name,url`。检查是否有大写字母、多余的列或缺少表头。
Add at least one non-empty data row to the CSV.	文件有表头但没有数据行。请至少添加一个名称和链接。
A CSV can contain at most 100 non-empty rows.	将列表拆分为每个最多 100 行的多个文件。
This CSV is malformed and could not be read.	从电子表格应用中重新导出文件。检查是否有未闭合的引号。

行错误

这些错误标记的是单独的行。你可以修正后重新上传，也可以仅使用有效行继续。

标记或消息	原因
MISSING / Name is required	`name` 单元格为空。
MISSING / URL is required	`url` 单元格为空。
INVALID / Enter a valid HTTP(S) URL	链接违反了某条 URL 规则。

行号将表头计为第 1 行，因此第一个数据行是第 2 行，与电子表格中的行号一致。

常见问题

表头看起来没问题，但仍然出现表头错误

表头必须为小写，且只包含两列。Name,URL 或 name,url,notes 都会失败。还请检查电子表格中 url 右侧是否有空列。

在浏览器中能打开的链接被标记为 INVALID

该链接可能包含空格，或使用了 http 或 https 以外的协议。请将空格编码为 %20 或删除空格，并使用完整的网址。

部分名称被缩短了

超过 40 个字符的名称会被截断为 40 个字符。如果你想自行决定措辞，请在文件中缩短名称。

指南

示例文件

规则

URL 规则

重复名称

逗号和引号

在电子表格中创建文件

验证错误

文件错误

行错误

常见问题

后续步骤

通过 CSV 创建二维码

批量创建概览

​示例文件

​规则

​URL 规则

​重复名称

​逗号和引号

​在电子表格中创建文件

​验证错误

​文件错误

​行错误

​常见问题

​后续步骤

通过 CSV 创建二维码

批量创建概览

示例文件

规则

URL 规则

重复名称

逗号和引号

在电子表格中创建文件

验证错误

文件错误

行错误

常见问题

后续步骤