要在线翻译 CSV 文件，只需导入文件、选择文本列、指定目标语言，并将译文保存到新列中。ID、SKU、价格、URL 和日期应保持不变；完成后检查译文，再按目标系统要求的格式导出。
我建议按列翻译，而不是把整个 CSV 粘贴到翻译工具中。这样既能保留行列结构，也方便逐行对照原文与译文。CSV 可能包含带引号的逗号、字段内换行符，以及看起来像数字的标识符；文件导入、翻译和导出后，这些内容都必须保持完整。
本指南将使用 Datablist 的 Google Translate、Deepl Translate 和 Translate with OpenAI/ChatGPT enrichments。正式处理整个文件前，请先用有代表性的样本测试不同 provider。翻译会使用已配置的服务，以及账户中的可用 credits 或符合条件的 provider key；免费注册并不代表可以无限量批量翻译。
第 1 步：导入 CSV 文件
本指南中的所有操作都将在 Datablist 的 CSV Viewer and Editor 中在线完成。
本例将使用一个“图书摘要”CSV 文件。你可以在这里获取演示 CSV 文件。
首先创建一个新 collection，用于存放 CSV 数据。点击侧边栏中的 +，或首页上的 Start with a CSV/Excel file。
如果使用侧边栏中的 +，请选择 Import CSV/Excel，进入 CSV 导入工具。
加载 CSV 文件后，Datablist 会列出检测到的所有列，并分析每列的数据类型。在需要翻译的数据列中，如果尚未选择，请将类型设为 Long Text。
使用“Long Text”后，管理长文本会更加方便。
检查数据，然后将 CSV 内容导入 Datablist。
第 2 步：选择需要翻译的记录
Datablist 提供“Enrichment”功能来处理数据。你可以直接基于现有数据丰富 Facebook leads，或清理 email 列表。
你可以选择 Google Translate、Deepl Translate 或 Translate with OpenAI/ChatGPT。既可以只使用其中一个，也可以全部试用，再判断哪一个最适合你的文本。
重要提示 - Enrichments 仅对注册用户开放。免费注册后即可开始翻译 CSV 文件。
Enrichments 位于 Enrich 菜单中，可以对全部记录或选中的记录运行。
翻译全部记录
开始前，请检查目标行和运行范围。当前选择、筛选条件或运行设置都可能改变实际处理的记录；不要想当然地认为每一行都会被翻译。
翻译指定记录
如果只想翻译部分记录，请按住鼠标并在复选框上拖动。
第 3 步：翻译 CSV 文件
要查看 Datablist 中可用的机器翻译 provider，请点击 Translations 分类来筛选 enrichments。
以下是 3 个翻译 provider 的快捷入口：
使用 Google Translate 翻译 CSV 文件
在 enrichment 列表中选择“Google Translate”，打开配置面板。
翻译 CSV 前，需要完成设置并指定输入数据。
你需要配置以下选项：
- Source Language - 可选 - 如果不指定，系统会自动识别源语言。 如果文本包含多种语言，请不要选择固定的源语言。
- Target Language - 必填 - 选择目标语言。语言名称以英文显示。查看支持的语言。
对于混合语言文件，可以先检测每一行的源语言，再只翻译确实需要处理的记录。
将 Text to translate 映射到 CSV 文件中包含原文的 property。其他列不会被翻译，因此你可以只翻译一个 CSV 列，同时完整保留其余列。
本例中的图书摘要位于“Description”property，因此我选择“Description”。
📕 重要提示
只有 Text/Long Text 类型的 properties 可以翻译，其他数据类型会被忽略。
继续配置输出映射，将 Translated Text 保存到一个新的 property。
在这里点击“+”按钮，为 collection 新建一个 property。
📘 说明
请将输出映射到单独的 property，以便保留原文进行对照。运行前，检查映射关系和 existing-data rule。最后一步中可以管理 properties，使导出的列名符合要求。
选择 Continue with Instant Run，然后配置一个小样本。样本应覆盖文件中出现的各种格式；如果包含多行文本或结构化内容，也要把它们纳入测试。
这一步可以帮助你确认配置是否正确。横向滚动数据表，查看译文。如果翻译效果不理想，请检查“Source Language”或输入 property。
检查样本后，确认处理范围和运行设置，再继续处理其余行。
使用 Deepl 翻译 CSV 文件
Deepl Translate 除了目标语言和源语言设置，还提供 Formality、Context 等高级选项。请用自己文件中的样本评估术语和语气，不要预设某个 provider 在所有场景下都更好。
输入和输出配置流程与 Google Translate 相同，只需在目录中选择 Deepl Translate。根据具体目标语言，检查其支持的语言和可用高级设置。
使用 ChatGPT 翻译 CSV 文件
Translate with OpenAI/ChatGPT 支持配置语言、model 和额外 instructions。需要统一术语、保留 placeholder 或指定语气时，这项功能尤其适合。不过，instructions 只能引导输出，结果仍需验证。
设置 Target Language 和可选的 Source Language，映射 Text to translate，再将 Translated Text 保存到单独的 property。如果 provider 的选择会影响业务结果，请使用相同样本进行比较。本指南不主张任何普遍适用的质量排名，也不承诺固定的成本优势。
如何选择其他 ChatGPT model？
使用 Datablist 翻译 CSV 数据时，可以选择不同的 ChatGPT model。
打开 Advanced Settings，查看 GPT Model。请以 enrichment 当前提供的 model 和费用估算为准，不要照搬旧文章里的 model 列表。
先选择适合任务的 model，再比较样本质量和系统显示的用量。样本应包含短描述、长段落、有歧义的术语和受保护的值。某个 model 即使能妥善处理简单记录，面对复杂内容时仍可能需要更明确的 instructions 或人工审核。
界面显示的字符数估算只能用于规划。OpenAI 翻译用量根据 model 的 token 使用量计算，因此不能只靠输入长度确定最终成本。比较不同批次时，请保持 model 和 instructions 一致。
如何处理复杂翻译？
有些文本很容易翻译，另一些就没那么简单。
翻译以下内容时，你可能已经遇到过问题：
- HTML 代码
- JSON 格式的内容
- 包含英文行业术语的商务文本
- 产品名或公司名
- 表单标签或 placeholder
- 包含
{first_name}或[LINK]等变量的句子
我把这类任务称为**“不能改坏结构”的翻译**：文字要换成另一种语言，但结构和关键术语不能发生变化。
这时，custom instructions 就很有帮助。
在 Translate with OpenAI/ChatGPT 中打开 Advanced Settings，然后选择 Extra Instructions。根据输入内容使用 Keep XML or HTML structure、Keep JSON structure 或 Custom Instructions。这些设置可以引导 model，但在导入结果前仍需验证。
下面来看几个实际例子。
1. 不翻译常用商务术语
你通常会希望保留“API”“CRM”“lead”“SaaS”等词。
2. 保护 HTML 和变量
如果文本包含 HTML 标签或变量，而你没有明确提出保护要求，ChatGPT 可能会改动它们。
👉 输入：
<p>Hello {first_name}, welcome to <b>Our App</b>!</p>
👉 Custom instruction：
✅ 结果（西班牙语）：
<p>Hola {first_name}, bienvenido a <b>Nuestra App</b>!</p>
3. 翻译 JSON 或结构化内容
JSON 处理起来比较棘手：只要一个引号出错，整个 JSON 就会失效。JSON 经常用于产品目录，也常见于应用本地化。
如果源文件是原始 JSON 而不是 CSV，请先使用 JSON to CSV Converter 进行转换，再翻译生成的列。
👉 输入：
{
"title": "Your payment was successful",
"description": "You can now access premium features."
}
👉 Custom instruction：
✅ 结果（法语）：
{
"title": "Votre paiement a été effectué avec succès",
"description": "Vous pouvez maintenant accéder aux fonctionnalités premium."
}
4. 保留产品名或品牌名
假设你的应用名为 Formly，并且不希望它被翻译。
👉 Custom instruction：
5. 调整语气或正式程度
想在德语中使用正式语气，在西班牙语中使用随和语气？
👉 Custom instruction：
实用技巧：组合多条 instructions
多条要求可以组合使用。
👉 示例：
Custom instructions 应具体明确，并用源数据进行测试。对于 JSON，请解析结果并对比 key；对于 HTML，请查看渲染结果，并检查链接和 placeholder。文本看起来正常，并不代表结构一定没有问题。
分批处理 CSV 数据
需要翻译大型 CSV，或者正在测试不同的 instructions 或 model？没有必要一次处理全部数据。
你可以每次只对少量记录运行 enrichment。
使用 Number of items to process 设置，控制单次运行要处理的行数。
从上次停止的位置继续
处理完一个批次后，可以稍后回来继续运行 enrichment。
点击 enrichment 列，然后选择 Run Enrichment。
系统会使用之前的设置打开 enrichment 面板。
重新运行前，请检查 configured processed-status 和 existing-data rules。它们决定哪些行会被跳过或覆盖；仅仅打开同一个 enrichment，并不能证明系统只会处理尚未完成的行。
如需重新处理全部记录或指定记录，请使用 Run on 选项并选择处理范围。
想重新生成以前的结果？
也许你想尝试另一个 GPT model，或者更新 custom instructions。
这种情况下，请将 Existing data rule 改为 Overwrite existing data in output properties (default)。
这样，旧值就会被新结果替换。
💡 使用建议
测试多个 prompt 时，先分别在小批量数据上运行并比较结果。选出最佳方案后，再处理整个列表。
第 4 步：检查翻译结果
译文会写入映射到 Translated Text 的 property。审核时，请将原文、译文和源 ID 保留在一起。
机器翻译必须经过检查。以一条西班牙语产品记录为例，应保持 SKU AC-001 和产品名 Acme 不变，同时将“Red cotton shirt”翻译为“Camisa roja de algodón”，并把译文保存到单独的描述列中。这只是用于说明理想输出结构的示例，并非对某个 provider 的实测结果。
| 字段 | 源值 | 建议处理方式 |
|---|---|---|
| SKU | AC-001 | 保持不变。 |
| 描述 | Red cotton shirt | 将审核后的西班牙语译文保存到新列。 |
| URL | https://acme.example/products/tee | 保持不变。 |
| 模板文本 | Hello {first_name} | 翻译问候语，同时完整保留 placeholder。 |
重新导入前，请使用 CSV parser 或电子表格重新打开下载的文件，并对比源 ID、行数、表头和受保护的值。字段内的逗号和换行符应保持原样。即使某句话翻译正确，如果列错位或标识符被改动，文件仍然无法使用。
检查译文时重点关注：
- 姓名、品牌名和行业术语 - Google 可能会翻译产品名或技术词汇。不要依靠大小写来保护品牌或产品名称；请明确列出不得翻译的词，并检查结果。
- 变量 placeholder - 如果文本用于软件应用，请检查所有不得翻译的变量 placeholder。
要快速阅读和编辑译文，请在单元格上按“Enter”进入编辑模式。
也可以打开详情面板。
第 5 步：导出 CSV 或 Excel 翻译文件
最后，将数据重新导出为文件，以便导入你的应用。具体操作请参阅导出 CSV 或 Excel 数据文档。
如果希望导出文件与原 CSV 使用相同的列，请编辑 properties，使其与原始列一致。
点击 properties 管理按钮。
然后：
- 重命名源 property
- 隐藏源 property
- 重命名包含译文的新 property，使其与源列名称一致
观看下面的视频，了解完整步骤。
CSV 文件翻译完整指南
如何统计待翻译字符数？
Datablist 提供了便捷的数据计算工具。使用 Characters count calculation，可以统计某个 property 的字符总数。
点击 property 列，然后选择 Perform calculation。
接着选择 Characters count。
结果会直接显示在面板中。
说明
Calculation 会基于当前视图运行。如果设置了筛选条件或选中了部分记录，系统将只计算这些数据，而不是全部记录。
翻译 provider 如何收费？
请查看 enrichment 当前显示的费用、可用余额，以及样本运行所报告的用量。字符数有助于规划任务，但不同 provider 和 model 的计费方式可能不同。不要对所有账户套用同一个每 credit 美元价格，也不要根据旧 model 推断普遍适用的节省比例。
对于 Translate with OpenAI/ChatGPT，credit 消耗取决于 model 的 token 用量。额外 instructions、原文长度、译文长度和所选 model 都可能影响用量。按每千个源字符计算的固定估算并不是价格保证。
应该选择哪个翻译 provider？
请根据语言、上下文、结构化内容设置和所需的审核质量进行选择：
| Enrichment | 需要检查的设置 | 样本检查重点 |
|---|---|---|
| Google Translate | Target Language 和可选的 Source Language | 代表性记录中的含义和术语。 |
| Deepl Translate | 可用语言，以及受支持语言中的 Context 和 Formality | 短标签、语气和技术术语。 |
| Translate with OpenAI/ChatGPT | GPT Model 和 Extra Instructions | 受保护名称、placeholder、HTML、JSON 和用量。 |
建议使用相同的原文记录和目标语言比较各个 provider，再由熟悉目标语言的人审核准备采用的结果。样本中应包含复杂情况，这样测试结论才能反映你真正要翻译的文件。
如需翻译产品目录，请参阅规模化 AI 翻译。如果需要使用独立行输入的通用 prompt，请参阅使用 LLM 处理电子表格。
CSV 翻译的常见应用场景
CSV 文件通常不只包含纯文本，还可能混合产品字段、ID、日期、标签、URL 和文本列。
以下是一些可以使用 Datablist 翻译的常见文件：
- 包含标题、描述和卖点列表的电商产品目录
- Shopify、WooCommerce 或 Magento 导出文件
- 包含标签和消息的应用本地化文件
- 来自电商平台或问卷工具的客户评价
- 客服工单和 helpdesk 消息
- 博客或 CMS 导出文件
- 销售备注、CRM 备注和公司简介
- 职位描述和招聘消息
只翻译文本列，ID、SKU、价格、URL 和日期应保持不变。
批量翻译 CSV 检查清单
开始大型翻译任务前，请检查以下事项：
- 选择正确的文本列。
- 保持原始列不变。
- 将译文写入新列。
- 如果原文较短，请指定源语言。
- 使用 custom instructions 保护 placeholder、HTML、JSON 或品牌术语。
- 先运行前 10 行。
- 检查名称、产品术语、链接和变量。
- 处理剩余记录。
- 只导出需要的列。
这样可以避免最常见的翻译问题，包括 placeholder 损坏、ID 被翻译、原文被覆盖以及语气不一致。
CSV 文件翻译的常见错误
翻译 CSV 文件时，请避免以下错误：
- 把整个文件当作一个文本块翻译
- 翻译 ID、SKU、日期或 URL
- 尚未审核就覆盖源列
- 忘记保护
{name}或{{email}}等 placeholder - 翻译 JSON 的 key 而不是 value
- 未测试 10 行就直接运行大型文件
- 跳过对产品名和行业术语的检查
翻译 CSV 的最佳方式是每次只处理一个文本列，并保持其余结构不变。
为什么批量翻译适合使用 CSV？
CSV 是一种使用文本文件存储结构化数据的格式。在 CSV 文件中，每一行都是一条数据记录，每条记录由逗号分隔的字段组成；有时也会使用分号“;”或制表符。
CSV 是应用之间传输数据的常见方式。由于它以文本文件为基础，导出数据库或电子表格数据十分方便。任何文本编辑器都能打开 CSV，但要避免在处理文件时引入错误，最好使用 CSV editor。
大多数应用都支持将数据导出为 CSV。你可以翻译指定列，再把翻译后的 CSV 文件重新导入原应用。
任何包含文本列的结构化列表都很适合使用 CSV 表示。
例如：
- 翻译包含标题和描述等文本列的产品目录
- 使用包含标题和正文的结构化文件翻译博客文章
- 翻译用户评价列表
可以免费翻译多少内容？
请在应用中查看所选 enrichment 当前提供的额度和账户 credit 余额。不同翻译服务的设置和可用性并不相同。免费注册不代表可以无限翻译，付费 collection 的额度也不等同于翻译配额。
可以使用自己的 DeepL API key 吗？
Deepl Translate enrichment 为付费账户提供 Deepl API Key 设置。配置后，翻译将使用你的 provider key，而不是 Datablist 的 credit 系统。你的 DeepL 账户仍会照常统计用量并计费。批量运行前，请检查该功能是否可用，并确认选择了正确的 key。
人工翻译与机器翻译怎么选？
机器翻译依靠自动化软件把源内容转换为目标语言。优秀的自动翻译 provider 会利用人工智能和机器学习提供高质量译文。
专业译员则更擅长处理复杂文本。当上下文非常重要、篇幅较长，或术语具有较强的技术性和专业性时，人工翻译通常更胜一筹。
我更推荐混合翻译模式：先用机器翻译，再由人工审核和改写。对于网页国际化，这种方式尤其合适。
支持哪些语言？
请在所选 enrichment 中查看 Target Language 和 Source Language，确认是否支持你需要的语言组合。各 provider 的语言目录会不断调整，因此本指南不提供固定的语言数量。对于简短或有歧义的原文，应先进行测试，不要默认自动语言识别一定准确。