给网页翻译加术语库，让代码文档翻译更准确

核心摘要

读外文技术博客、GitHub README 或云厂商文档时，网页翻译不准确的问题格外明显：代码里的 Promise 被译成「承诺」，API 文档里的 timeout 被译成「暂停」，同一个 scheduler 前一段是「调度器」、后一段变成「日程表」。这类问题不是翻译工具能力不够，而是通用翻译引擎对技术术语缺少统一译法。沉浸式翻译的 AI 术语库就是针对这个场景设计的：为编程、科技、金融、法律等垂直领域预置专业词库，让术语译法稳定落在正确义项上。

• 开启对应领域术语库后，插件识别到收录词汇会优先使用库中译法
• 内置覆盖编程、科技、法律、医学、金融等垂直领域，不足时可用 .csv 自建术语库
• 术语库需配合 AI 翻译引擎使用，传统机翻引擎无法直接调用

一、网页翻译不准确，技术文档里通常是这三类原因

日常资讯用浏览器自带的翻译大概能读，但一到代码注释、API 文档、技术白皮书，网页翻译不准确的问题就暴露出来。拆开看，通常能归到三类。

第一类是专业术语被按日常义项翻译，这也是最影响阅读的一类。通用翻译引擎面对多义词时，会优先选择语料里出现频率更高的日常含义，而不是当前语境下的技术含义。比如 Promise 在 JavaScript 里是异步编程概念，应译为「Promise」或保留原词，硬译成「承诺」就让人摸不着头脑；scheduler 在操作系统或框架里应译为「调度器」，译成「日程表」就完全偏离原意；render 在图形/前端领域是「渲染」，译成「呈递」也不贴切。一个关键术语的义项选错，整段代码逻辑或 API 说明就可能出现偏差。

第二类是长句翻译后逻辑割裂。技术文档里常见嵌套从句、被动语态和多个修饰成分，译成中文后主语和谓语对不上，条件与结论之间的联系被拆散。看 Kubernetes 官方文档、数据库白皮书或云厂商 API 说明时尤其常见，原本严密的论证链变成一堆碎片信息。

第三类是同一个词全文译法不统一。API 参数 timeout 前一段是「超时」，后一段变成「暂停」；hook 前一段是「钩子」，后一段变成「挂钩」。读代码文档时，这种不统一会让人怀疑是不是在说同一个东西。

二、用 AI 术语库给专业词汇定译法

网页翻译不准确最常见的两类表现，就是术语义项选错和全文译法不统一。在沉浸式翻译这个翻译插件里，有一个专门的功能来解决这个问题，就是 AI 术语库。它的工作方式很简单：启用后，插件检测到术语库收录的词汇时，会优先使用库中的译法，而不是让翻译引擎自己去"猜"。

目前内置的术语库覆盖了编程、科技、法律、医学、金融、电商、教育、游戏、小说、web3 等垂直领域，挑自己常用的打开就行。

启用路径很直接：打开插件面板卡片 → 点击「设置」→ 左侧找到「AI 术语库」→ 打开对应领域的开关。

内置不够用时，用 .csv 自建术语库

如果你看的代码框架、内部 API 或小众技术栈不在内置词库里，可以用 .csv 文件自建一份。格式只有三列：原文、译文、备注，一行一条术语。例如做前端开发时，可以建这样一份小型术语库：

原文,译文,备注
Promise,Promise,JavaScript 异步对象，保留原文
scheduler,调度器,操作系统/任务调度语境
render,渲染,前端/图形渲染语境
hook,钩子,React/Vue 等框架中的生命周期钩子
timeout,超时,API 参数，指请求超时时间
middleware,中间件,Express/Koa 等框架组件

建好后上传到插件后台启用即可。该功能在 GitHub 开源，也接受用户贡献术语库，已建立几十个大类。长期深耕同一类技术内容的人，自建一份会越用越贴合自己的阅读场景。

AI 术语库默认配合 AI 翻译引擎运行。如果当前用的还是机器翻译的引擎，需要先切换到 AI 翻译引擎。不确定哪个引擎更适合自己的阅读内容，也可以用沉浸式翻译的文本翻译功能做对比：把一段常看的专业文字贴进去，分别勾选两三个引擎翻译，哪个模型的译文读着更通顺、术语更准确，就选哪个。

三、看长篇文章，可以再打开 AI 精翻

术语库解决的是每个专业词该译成什么。但如果看的是长篇文章，还有一个问题是全文翻译的一致性：同一篇技术文档里，前面提到的术语译法、人名、缩写，翻到后面还能不能保持一致？

沉浸式翻译的 AI 精翻就是针对这个场景的。它的思路是：先让模型对整页内容做摘要，包括关键的名词和专业术语，再在逐段翻译时带上这份摘要。这样模型在处理每个段落时都能"想起全局"，全文的术语和断句会更统一。启用也很简单，在插件面板选择支持该功能的翻译服务，打开「AI 精翻」开关即可。

四、几个可能被忽略的边界

• 机器译文和 AI 译文都不是百分百准确，重要内容仍建议结合原文或人工进一步确认
• 术语库解决"词"的问题，句子层面的理解偏差还得靠引擎的上下文能力
• 自建术语库需要前期整理成本，适合长期深耕同一类内容的人

五、FAQ

Q1. 为什么开了术语库还是没生效？

可能是引擎没切到 AI 翻译引擎。谷歌、DeepL 属于传统机器翻译引擎，得先把翻译服务切换到 AI 翻译引擎，术语库才会起作用。

Q2. 内置术语库和自建术语库怎么选？

先看内置的够不够用。内置词库覆盖编程、科技、金融、法律等常见领域，多数人够用；如果你看的内容属于更细分的领域，比如某个冷门框架或公司内部 API，内置词库覆盖不到，可以考虑自建。

Q3. 切换引擎会不会影响已经翻译好的页面？

不会。切换引擎后，新触发的翻译使用新引擎，之前已翻译的页面保持原样。想让已翻译的页面也用上新引擎，手动刷新页面，重新翻译即可。

六、结论

云厂商文档、前端框架文档、金融研报——看什么样的内容就打开对应领域的术语库。设置好 AI 翻译服务，网页翻译不准确的问题会有明显改善。如果内置词库覆盖不到你的领域，也可以用表格自建一份，长期看这类技术内容会更顺手。