在HelloWorld里导入自定义词库的核心步骤是：准备符合平台规范的表格（常见为CSV/TSV或TBX），统一为UTF-8编码并做去重与占位符处理，然后在词库管理界面或通过API上传、映射字段（源语、目标语、词性、优先级、备注等），运行系统校验并合并。导入后用质量检查工具审查冲突、优先级与上下文匹配，必要时回退并调整词条版本与责任人记录。
先说为什么要把词库导入到HelloWorld
把自定义词库导入平台并不是炫技，而是提高翻译一致性、品牌声音和术语管理效率的根本手段。想象你公司有一套固定的产品名称、专用术语或法律用语：如果每次翻译都靠人工记忆或即时机翻，结果会参差不齐，影响用户体验和合规性。把词条结构化、版本化并接入翻译流程，可以让机器翻译、翻译记忆（TM）和人工校对都“说同一套话”。
导入前的准备工作（别跳过）
文件格式与编码
- 推荐格式：CSV（逗号或制表符分隔）、TSV、TBX。CSV最通用，但需注意分隔符与引号。
- 编码：必须使用UTF-8（无BOM）或按平台要求。错误编码会导致中文、特殊字符或占位符乱码。
- 列分布：至少包含源语（source）、目标语（target）；建议增加词性（pos）、领域（domain）、优先级（priority）、备注（note）、上下文示例（context）等列。
字段设计与规范
字段越清楚，后续映射越省事。常见字段定义：
- source：源语言词条或短语（精确文本）
- target：目标语言对应翻译
- context：一句话示例或使用场景
- pos/domain：词性或行业领域（如UI、法律、医疗）
- priority：优先级（HIGH/MEDIUM/LOW），决定冲突时的覆盖规则
- note：给译者的说明或品牌用语要求
整理与清洗（关键但常被忽略）
- 去重：相同源语但目标语不同，要合并并注明适用场景；不同大小写或标点也要统一。
- 占位符处理：把%1$s、{0}类占位符统一为平台接受的格式，记录原始语法。
- 标签与HTML：若词条包含HTML/Markdown标签，添加额外字段标注是否应保留标签或转义。
- 版本与责任人：在表格中加上version、owner便于追踪变更。
CSV/TSV 模板（示例表格）
| source | target | context | domain | priority | note |
| Sign in | 登录 | 按钮文案：用户登录系统 | UI | HIGH | 首字母大写，保持简洁 |
| Order | 订单 | 名词，用于商务流程 | eCommerce | MEDIUM | 与“顺序（order）”区分 |
一步一步：通过界面（UI）导入的完整流程
- 登录并进入词库管理：在HelloWorld平台找到“词库/Glossary”或“术语管理”。
- 选择导入/新建词库：如果已有词库，考虑先备份现有版本；若新建，填写语言对与基本信息。
- 上传文件：选择准备好的CSV/TSV/TBX文件，注意选择正确的分隔符和编码选项。
- 字段映射：把上传文件的列映射到平台需要的字段（source→源语、target→目标语等）。
- 预校验：系统通常会做格式校验（缺列、编码异常、非法字符）并给出错误行。修正后重新上传。
- 合并规则设置：选择覆盖现有、跳过或创建新条目；指定优先级策略。
- 执行导入并查看日志：导入完成后查看结果日志，有无冲突、跳过条目或重复。
- 上线前测试：在测试项目或小样本中启用词库，观察机器翻译+TM是否按词库优先替换。
通过API/自动化脚本导入（适合频繁更新）
当词库需要频繁同步（例如与产品库、CMS或工程词表联动）时，使用HelloWorld提供的API或CLI会更高效。一个典型的自动化流程：
- 在代码仓库或Excel中标准化词库并导出CSV。
- CI/CD任务触发脚本，调用HelloWorld的上传API（通常需要API Key和词库ID）。
- API返回预校验报告，脚本根据结果决定是否继续或发送通知给责任人。
- 自动记录版本号、提交人和变更摘要到日志（便于回溯）。
API导入时的注意点
- API速率限制：避免并发爆发上传，分批次导入。
- 幂等性设计：为每次上传设置唯一版本号，失败可重试但不会重复创建条目。
- 安全：使用密钥管理，限制接口权限（仅允许词库写入/读取）。
冲突、覆盖与优先级处理
导入过程常见问题是“词条冲突”——相同源语已有不同目标语。处理策略通常有三种：
- 覆盖（Overwrite）：新导入的词条直接替换旧的；适用于全量更新。
- 跳过（Skip）：保留已有条目，忽略重复项；适用于追加式更新。
- 合并（Merge）：保留多条目标语并通过优先级或上下文区分；适用于多语境场景。
建议给高敏感词（品牌名、法律术语）设置强制覆盖或锁定，并把“谁可以编辑”权限限定给小组。
导入后如何验证质量（实操清单）
- 用TM/MT预览：选择典型的翻译记忆匹配和机器翻译输出，确认词库条目被正确应用。
- 做词频检查：统计出现次数异常的词条，排查误导替换。
- 上下文回查：对带context字段的条目，验证在实际句子中是否自然且无歧义。
- 人工抽查：抽样20–50条由母语译者复核，记录问题类型与修正建议。
- 回滚与版本控制：如果出现严重问题，回退到前一版本并分析引入错误的变更记录。
一些易犯的错误与解决办法
- 编码错误：表现为乱码或字段分割异常。解决：统一转为UTF-8，去除特殊BOM，检查换行符。
- 占位符丢失或格式改变：在导入或映射过程中被错误处理。解决：在note中保留原始占位符格式，使用正则检测占位符一致性。
- 大小写与空格不一致：导致重复条目。解决：导入前进行规范化（trim、lower/upper as needed）。
- 含HTML标签的词条被转义：视需求决定保留或转义，必要时在字段中标注allow_html=true。
如何让词库真正被用起来（落地技巧）
- 在翻译工作流中默认启用词库，确保机器翻译、CAT工具和人工校对都可访问。
- 把品牌Slogan、功能名列为高优先级并锁定编辑权限。
- 建立反馈渠道：译者在遇到歧义或错误时可以直接在词库条目标注并触发改版流程。
- 定期审计：每季度或每次重大产品迭代后做一次词库健康检查。
示例：一个小型词库工作流
假设你负责一个移动App的中→英本地化：先从产品团队导出一份UI字符串，清洗并标注上下文和占位符，生成CSV模板，提交到HelloWorld的测试词库，调用API上传并映射字段，启用词库在测试项目里，观察MT/TM输出并做人工抽检，确认无误后把词库合并到生产库并锁定高优先级条目。
最后，再说几个实用小贴士
- 在词库里保留“示例句”比单独的note更有价值，能减少歧义。
- 保留原始文件的备份与变更日志，便于出现问题时回溯。
- 把导入过程写成标准操作手册（SOP），并把常见错误和解决办法放进去，让团队新人少走弯路。
- 不要把所有术语都放入高优先级，优先级滥用会让上下文敏感的词被错误替换。
说到这里，差不多把从准备文件到自动化上传、冲突处理、质量验证和持续维护的关键点都摆清楚了。你可以先做一个小规模试验，把流程跑透，再逐步扩大词库规模和自动化程度——这样出问题也容易控制，团队也能更快上手。若你需要，我可以帮你把现有的Excel表格检查一遍，给出一份可直接导入HelloWorld的CSV模板和校验脚本。