snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)

packages/twenty-docs/l/zh/user-guide/data-migration/capabilities/file-formats.mdx

@@ -0,0 +1,48 @@
+---
+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>