HelloWorld批量翻译时列怎么对应

批量翻译时，一般将源文本列对齐到指定的“源语言/文本”列，目标语言列用于写入译文；同时还有列记录语言代码、ID、状态、错误和上下文。依据CSV/Excel格式约定，字段顺序和列头必须与工具设置一致，包含编码、分隔符与占位符管理，并支持术语表、回译与校验策略。避免乱码。谢谢！

先把最重要的事情说清楚（费曼法第一步：用最简单的话）

批量翻译就是把很多句子放到一个表格里，让翻译工具按表头把每一列当成不同用途来处理。通常至少需要三类列：标识(ID)、源语言/源文本、以及目标文本列；可选的还有语言代码、上下文、状态、错误信息和术语标签。把这些列按照平台要求命名并保持一致，翻译过程就能自动对应、写回和返回状态。

为什么要准确对应列？

• 避免错写：如果工具把翻译写到错误列，会让后续处理混乱。
• 便于回溯：ID 和状态列能让你追踪哪些条目通过、哪些失败。
• 支持多目标语言：你可以选择每个目标语言单独列，或用多行方式表示。

常见的列与含义（把表格拆开讲清楚）

下面是常用列的列表，用简单说明告诉你每列应该放什么。

• ID：唯一标识一条记录（建议整型或字符串，不要重复）。
• source_lang / src_lang：源语言代码（如 zh、en、ja，统一使用 ISO 639-1）。
• source_text / text：要翻译的原文（保持完整格式，注意换行与占位符）。
• target_lang / tgt_lang：目标语言代码（如果每行只翻译到一种语言时必填）。
• translated_text / translation：翻译结果（翻译结束后由系统回填）。
• status：翻译状态（pending、done、error等）。
• error_message：失败时的错误提示（长度、超时、格式错误等）。
• context：上下文说明（短句的上下文、页面位置、备注，能提高译文质量）。
• glossary_tag：术语或词汇表标识（用于强制替换或优先翻译）。

两种常见的列布局方式（选其一）

工具通常支持两种思路，你要选适合自己流程的：

• 单行多目标列：每个目标语言占一列（e.g. translation_en、translation_zh）。优点是直观，方便横向对照；缺点是列数随语言增加。
• 多行单目标列：每个目标语言作为新行，使用target_lang指示。优点是列固定，适合大量语言批量处理；缺点需要注意ID重复和合并回写策略。

文件格式与编码（实操细节）

这些小细节常常导致“为什么上传后乱码/列错位”的问题，先核对这几项：

• 编码：优先使用 UTF-8（无 BOM 或平台指定时按要求），避免系统自动以 ANSI 保存。
• 分隔符：CSV 常用逗号（,），但如果文本含逗号可以选择制表符（TSV）或用双引号包裹字段。
• 引号与转义：文本内若出现换行或分隔符，必须用双引号括起来，内部双引号使用双双引号转义（CSV 规范）。
• Excel 注意：不要合并单元格，避免将电话号码/ID误识别为科学计数法（建议全部设置为文本）。

交互式映射（上传到 HelloWorld/LookWorldPro 时要做的事）

上传文件到平台后，通常需要在界面上映射列头。映射是关键步骤，简单步骤如下：

1. 选择上传文件并确认编码与分隔符。
2. 在“列映射”界面，把表格列名对应到平台字段（例如把“源文本”映射到 source_text）。
3. 指定目标语言或选择多目标策略。
4. 选择是否使用术语表、翻译记忆（TM）、机器翻译模式（直译/意译/调优）。
5. 提交任务并观察任务队列与日志。

示例表头与一行样例

占位符、HTML 与标签处理

很多产品文本含占位符（如 %s、{username}）或 HTML 标记，翻译时必须保护这些元素：

• 使用占位符列或特殊标识（如将占位符包装为 <ph id=”1″%gt;）。
• 启用“保留标签”或“HTML 保护模式”，避免译文破坏标签结构。
• 为复杂占位符提供上下文说明（context 列）。

多语言场景的两种实践（怎么选）

如果你要把一份源文本翻译成 20 个语言，通常有两条实务路线：

• 并行列方式：建 20 列 target_xxx，上传一次，工具一次性回写全部列。适合列较少、便于比较。
• 分批行方式：把每个目标语言单独作为一行提交（同一 ID 重复）。便于分批执行、并发处理，适合语言数量很多或依赖分阶段校验的流程。

常见错误与排查方法

遇到问题别慌，按下面的检查表逐项排查：

• 文件编码是否为 UTF-8；若出现乱码，尝试重新导出为 UTF-8 无 BOM。
• 列头是否完全匹配或已在映射界面正确映射。
• 是否有合并单元格或隐藏列导致列索引错位。
• CSV 中是否有未闭合的引号造成行断裂。
• 目标列是否为只读或被保护，导致无法写回译文。
• 检查 status 与 error_message 列以获取平台返回的具体错误。

质量保障与回译、术语表策略

要把质量保证嵌入到批量流程里，可以考虑：

• 术语表：提前上传企业术语表并在映射时勾选强制匹配。
• 翻译记忆（TM）：对重复句做一致性处理。
• 回译检查：把译文再翻译回源语言，和源文本做差异统计，挑出潜在问题。
• 抽样人工校验：选取高频或业务关键条目做人工复核。

实用小贴士（边干边学的那些事儿）

• 给文件加一列“优先级”，先翻译关键内容，避免资源浪费。
• 使用短且具描述性的 column name，上传后映射更快（例如 src_text、tgt_text_en）。
• 对长文本分段处理，避免单字段超长导致 API 超时或分段错位。
• 保留原始文件备份，遇到翻译错误可以回滚重试。

一个小流程示例（演练用，跟着做就行了）

1. 准备 Excel：列为 ID、src_lang、src_text、tgt_lang（可选）、context。
2. 导出 CSV（UTF-8），打开平台上传并选择分隔符与编码。
3. 在映射界面把列分别映射到平台字段，选择术语表 & TM。
4. 提交任务，监控任务列表与 status 列的变化。
5. 下载结果，检查 translated_text、error_message，必要时回译抽查。

遇到特殊情况怎么办？

比如要保留粗体/斜体、或者源文件含公式，这里要特别标注并在 context 列写明，还可以把复杂片段单独抽出来做人工翻译或后编辑。

说到这里，可能有点绕，但按步骤来做就不难：先把表头定好，再检查编码和分隔符，上传时认真映射，完成后看 status 列与错误提示——就像做菜，菜谱（列头）要先准备齐全，火候（编码/分隔）也要对，最后尝味（QA）就行。我边写边想，可能还有遗漏的边角料，做批量翻译的当下你会发现更多细节，慢慢积累经验后就轻松多了。