---
title: 支持的文件格式
description: 在 Twenty 中用于数据导入的受支持文件格式。
---

## 支持的格式

Twenty 支持三种导入文件格式：

| 格式            | 扩展名   | 备注          |
| ------------- | ----- | ----------- |
| **CSV**       | .csv  | 推荐，兼容性最佳    |
| **Excel**     | .xlsx | 现代 Excel 格式 |
| **Excel（旧版）** | .xls  | 旧版 Excel 格式 |

## 文件要求

| 要求       | 值                 |
| -------- | ----------------- |
| **编码**   | 推荐使用 UTF-8        |
| **记录上限** | 每个文件最多 10,000 条记录 |
| **结构**   | 第一行必须包含列标题        |
| **内容**   | 每个文件仅包含一种对象类型     |

## CSV 最佳实践

* **分隔符**：使用逗号（`,`）或分号（`;`）
* **文本限定符**：对于包含逗号的文本，请使用双引号（`\"`）
* **行结束符**：支持 Windows（CRLF）或 Unix（LF）
* **空值**：将单元格留空，不要使用 "NULL" 或 "N/A"

## Excel 最佳实践

从 Excel 导出时：

* 移除公式（仅导出值）
* 删除末尾的空行
* 确保没有合并单元格
* 仅使用第一个工作表

## 大型数据集

对于超过 10,000 条记录的数据集：

* 拆分为多个文件
* 或者使用 [API 导入](/l/zh/user-guide/data-migration/how-tos/import-data-via-api) 以导入无限数量的记录

<Note>对于非常大的迁移（100,000+ 条记录），API 比 CSV 导入明显更快且更可靠。</Note>
