HelloWorld导入Excel通常要求.xlsx/.xls/.csv兼容、文本为UTF-8编码（CSV建议带BOM），首行为字段名，必须包含源语与目标语列，建议附带ID与上下文列；避免合并单元格、公式、图片或富文本，段落按行分句，特殊占位符（{0}、%s、HTML标签）需统一标注并保留原格式。符合这些格式能保证批量导入、翻译记忆、术语表与QA规则正确匹配，减少映射错误与内容截断。
先说结论：为什么Excel格式很重要
把翻译任务交给机器或工具，Excel表格成了“搬运工”——它把源文句搬进系统，再把译文搬出。格式如果不规范，搬运就会出错：列错位、段落拆分错误、占位符丢失、术语对应失败，甚至影响翻译记忆（TM）与术语库的应用。换言之，Excel是翻译流程的信息契约，遵守规则就少麻烦。
从费曼法学会理解：把复杂问题拆成简单块
想象你在教一个朋友如何将菜谱从中文翻译成英文。你不会一次教他整个菜谱，你会把每道菜、每一步、每个数字拆开来教。Excel就是把“翻译大任务”拆成行（每行一段或一句）、列（每列一种信息）的方法。把每个单元干净、明确地放好，系统就能一步步处理。
HelloWorld支持的文件类型与编码要求
- 优先格式：.xlsx（推荐）与 .xls（兼容旧版）。
- 纯文本交换：.csv（逗号分隔），适合自动化流水线或脚本操作。
- 编码：Excel文件通常自带编码信息，CSV文件一定要使用 UTF-8 编码，建议保留 BOM（尤其在 Windows 环境下以防止中文乱码）。
- 分隔符：CSV 默认逗号分隔；当内容中包含逗号时，请使用双引号将字段包裹，或考虑使用制表符（TSV）代替。
关键列与模板结构（必备与可选）
把表头想象成合同条款——每个字段都要清楚定义。下面是常见且推荐的字段：
| 示例字段 | 用途 |
| ID | 唯一标识一条句子或段落，便于回溯、校对与合并。 |
| Source_Lang / Target_Lang | 指明源语言与目标语言（建议使用 ISO 639-1 代码，如 zh, en, ja）。 |
| Context / Topic | 提供上下文（场景、界面位置、用途），帮助提高译文准确性。 |
| Source_Text | 源文本（每行一段或一句）。 |
| Target_Text | 译文输出列，机器翻译或人工翻译结果写入。 |
| Glossary_Term / Term_ID | 用于术语匹配，列出需要强制或优先使用的译法。 |
| Status / Review | 任务状态（例如: new, translated, reviewed）。 |
| Notes / Comment | 用于说明疑难点或翻译者备注。 |
哪些是必须的，哪些是可选的？
- 必须：Source_Text、Target_Text（Target 可留空供翻译输出）、Source_Lang/Target_Lang 或通过项目设置指定、唯一 ID（建议）。
- 强烈建议：Context、Glossary_Term、Status、Notes。上下文能显著降低歧义，术语列能提高一致性。
- 避免依赖：富文本、Excel 注释、合并单元格或公式不要作为信息传递手段。
内容处理细节（占位符、HTML、换行与格式化）
这些细节决定翻译后能不能“原样回填”。下面是一些常见规则与建议：
- 占位符：例如 {0}、{name}、%s、%%、{user_name} 等，必须在源文中保持统一格式，并在表格中加注释说明含义。HelloWorld 会把占位符当作不可翻译片段，需要精准保留。
- HTML 或富文本标签：如果源文包含 <b>、<a> 等标签，建议把标签与文本分离或使用占位符替换标签再回填，避免翻译过程破坏结构。
- 换行与段落：尽量把可翻译单元做成“行级”单位（每行一句或一段）。单元格内的多段落会影响句子分割和统计。
- 空格与前后缀：保留必要的前后空格（尤其与占位符相邻时），并在Notes中说明是否需要修剪。
格式与Excel功能的限制
- 合并单元格：请完全避免。导入工具通常按行读取，合并会造成数据错位。
- 公式与引用：翻译内容应为纯文本；公式会在导入时被计算或丢失。
- 图片与媒体：无法直接导入。若需翻译图中文字，请先做 OCR 或把文字放入表格。
- 富文本格式（字体、颜色、超链）：导入通常只能保留纯文本。若样式重要，请在表格中额外标注样式信息列。
- 最大长度：不同平台对单元格长度有限制（几万字符），实际项目中建议单条不超过几千字符以保证稳定。
CSV 专门注意事项
CSV 看起来简单，但坑不少：
- 一定使用 UTF-8 编码（含 BOM 可减少 Excel 打开时乱码），否则中文或特殊字符会错乱。
- 若字段内包含逗号或换行，请用双引号包裹整字段，或选择制表符分隔（TSV）。
- 不要把列标题或注释放在文件顶部多余行，导入程序通常认为首行就是字段名。
- 确保每行列数一致，缺列用空字段占位。
语言代码与多语言表格策略
管理多语言时有两种常见做法：
- 纵向表（每行一语对）：每行包含 Source_Lang、Target_Lang、Source_Text、Target_Text。适合混合多语言的批量导入。
- 横向表（每列一种语言）：第一列为 ID 与上下文，后续列为 en、zh、ja 等。便于查看多语言并行，但在自动化处理时需注意列头精确匹配。
示例模板（建议直接复制使用）
下面是一个实用的模板示例，供项目启动或导入前统一格式：
| ID | Source_Lang | Target_Lang | Context | Source_Text | Target_Text | Glossary_Term | Status | Notes |
| 1001 | zh | en | 按钮标签 | 提交订单 | 提交|submit | new | 短文本，不加句号 | |
| 1002 | zh | en | 邮件主题 | 您的订单已发货 | new | 主题不要超过50字符 |
与翻译记忆（TM）和术语库对接的注意点
- 唯一 ID 与一致的上下文能大幅提高 TM 的命中率。
- 在表格中标注术语列并与术语库字段一致，导入时可实现自动术语替换。
- 保持源文稳定（不要频繁修改 ID 或字段名），否则会导致历史记录断裂。
常见问题与排查步骤（实用小贴士）
- 如果导入后中文出现乱码：检查 CSV 是否为 UTF-8，有无 BOM；尝试以UTF-8重新保存后再导入。
- 如果占位符翻译被改动：确认源格中的占位符格式是否和项目设置一致并在 Notes 中注明不可翻译。
- 如果表列错位：确认首行标题是否和系统设置一致，确认没有隐藏列或合并单元格。
- 如果翻译记忆未生效：检查 ID 是否变更、Source_Text 是否包含无关空格或控制字符。
工作流优化建议（省时又稳妥）
- 在初次导入前先用一小批（100–200 行）做试验，验证占位符、HTML 与术语的保留情况。
- 建立并共享一个“字段说明”Sheet 或文档，确保团队每次导出/导入遵循相同规则。
- 尽量在导入前把文本清洗（移除不可见控制字符、统一空格），并把图片文本提前抽取到表格。
- 使用版本号或时间戳命名文件（如 project_v1_20260510.xlsx），便于回溯。
写到这里我才想到，很多团队把 Excel 当成“临时数据库”来用，结果久而久之各种规则乱套，因此最好在项目启动就把模板固定下来。按我上面那些要点去做，绝大多数导入/导出问题都能避免，且对后续的质量检查和翻译一致性帮助很大。就像做菜一样，食材切好、调料标明，做出来的菜才不会走味。