> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getqr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CSV 格式

> 如何为批量创建准备 CSV 文件：必需的表头、数据行、URL 规则和验证错误。

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

## 示例文件

```csv bulk-qr-template.csv theme={null}
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 时会自动处理。

## 在电子表格中创建文件

**1. 设置两列**

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

**2. 每个二维码添加一行**

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

**3. 另存为 CSV**

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

> [!TIP]
>
> 以 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 规则](#url-rules)。 |

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

## 常见问题

> **表头看起来没问题，但仍然出现表头错误**
>
> 表头必须为小写，且只包含两列。`Name,URL` 或 `name,url,notes` 都会失败。还请检查电子表格中 `url` 右侧是否有空列。

> **在浏览器中能打开的链接被标记为 INVALID**
>
> 该链接可能包含空格，或使用了 http 或 https 以外的协议。请将空格编码为 `%20` 或删除空格，并使用完整的网址。

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

## 后续步骤

> **[通过 CSV 创建二维码](/zh/bulk/create-from-csv)**
>
> 上传文件并开始批次。

> **[批量创建概览](/zh/bulk/overview)**
>
> 限制以及批量创建的工作原理。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.