沉浸式翻译使用指南：3 步开启网页双语对照与文档翻译-编程实验室

沉浸式翻译使用指南：3 步开启网页双语对照与文档翻译

【免费下载链接】immersive-translate沉浸式双语网页翻译扩展 , 支持输入框翻译，鼠标悬停翻译， PDF, Epub, 字幕文件, TXT 文件翻译 - Immersive Dual Web Page Translation Extension项目地址: https://gitcode.com/GitHub_Trending/im/immersive-translate

凌晨一点读英文技术帖，遇到一段看不太懂的内容，切到翻译网站、粘贴、等结果、再切回来——思路断了。这个场景是不是很眼熟？沉浸式翻译（Immersive Translate）就是为这类场景准备的浏览器扩展：一个做双语网页翻译的工具，把译文直接排在原文旁边，同时支持输入框翻译、鼠标悬停翻译，以及 PDF、Epub、字幕文件、TXT 文件翻译。

它是什么：核心能力速览

一句话定位：装在浏览器里的双语网页翻译扩展，原文和译文同屏共存，不用来回切换标签页。

能力	说明
网页双语翻译	译文排在原文下方，可在双语对照与仅译文间切换
鼠标悬停翻译	鼠标停在词句上直接查看译文，不打断阅读
输入框翻译	表单、搜索框等输入内容时同步给出译文（默认快捷键 Alt+I）
PDF 翻译	加载 PDF 文档翻译，扫描件可先做 OCR 识别
Epub 翻译	本地电子书内阅读，译文随行显示
字幕文件翻译	视频字幕译成双语对照显示
TXT 文件翻译	纯文本文件直接翻译
多翻译服务	默认使用 Bing，可切换或接入自己的翻译 API
敏感信息脱敏	默认对手机号、银行卡号、密码等打码，降低内容外发风险

仓库里的构建产物按浏览器分放在 dist/chrome/ 和 dist/firefox/，另有基于油猴脚本的版本在 dist/userscript/；页面类文档放在 docs/ 下。

从 0 到 1 上手

第一步：获取

两条路：在浏览器扩展商店搜索"沉浸式翻译"直接安装；或者从仓库拉取发布产物：

git clone https://gitcode.com/GitHub_Trending/im/immersive-translate

仓库本身用于发布 Release 版本和跟进反馈，说明见 README.md。

第二步：基础配置

装好后打开选项页（右键扩展图标 → 选项），按顺序确认三件事：

翻译服务：默认是 Bing，可以换成其他服务，或配置自己的 API；
显示模式：选"双语对照"还是"仅译文"；
触发方式：进页面自动翻译，还是手动点击触发。

第三步：跑通第一个案例

打开任意英文网页，按Alt+A（默认整页翻译开关快捷键），页面上每段原文下会排上译文。想只看中文时，点一下显示切换即可。到这里，核心链路就算跑通了。

高频场景实测

场景一：读英文技术文档（适合开发者）

怎么用：文档页按Alt+A整页翻译，需要专注时切成仅译文；术语没把握时鼠标悬停核对。

实际效果：代码块和命令不会被翻译，保持原样；标题层级、列表结构完整，原文和译文位置一一对应，来回对照不用滚动找位置。

场景二：翻译论文与 PDF（适合研究者、学生）

怎么用：用 PDF 翻译入口直接加载文件；如果是扫描版，先走 OCR 识别再翻译。

实际效果：译文跟随原文档结构输出，长文档可以按章节翻着看。扫描版比文本版慢，识别准确率会影响最终译文质量，这点要有预期。

场景三：看外语视频、填外文表单（适合普通用户）

怎么用：视频页开启字幕翻译，字幕以双语形式显示；表单页里输入框翻译会同步给出译文（Alt+I手动触发）。

实际效果：看课程不用暂停查词；填境外网站表单时，能确认输入的内容是否表达准确。

常见坑与速查

1. 点翻译没反应

现象：点击后页面没有任何译文出现。
原因：页面还在加载，动态内容尚未注入；或该站点被加入了忽略规则；也可能是当前翻译服务不可用。
解决：等页面加载完再刷新重试；到选项页检查站点规则里是否忽略了该域名；换个翻译服务再试。

2. 只翻译了页面一部分

现象：上半部分有译文，往下滚动加载出的新内容没翻。
原因：为了控制首屏速度，扩展默认只翻译一定范围内的文本，随滚动动态加载。
解决：使用"翻译到页面末尾"的操作，或按Alt+W（整页翻译）一次性翻完。

3. 快捷键按了没反应

现象：Alt+A 等快捷键无响应。
原因：默认快捷键被改过，或被其他扩展、系统快捷键占用。
解决：Chrome 系浏览器到扩展快捷键管理页核对；Firefox 在附加组件设置（about:addons）里管理快捷键。

4. 翻译内容里数字、账号变成打码

现象：手机号、卡号、密码等在译文中显示为掩码。
原因：敏感信息脱敏默认开启，这些内容不会发给第三方翻译服务。
解决：这是预期行为，原文本身不受影响；如果确认安全，可在选项页的脱敏配置中按需调整。

5. 扫描件 PDF 翻得很慢

现象：加载扫描件后要等很久才出第一批译文。
原因：扫描图片要先在浏览器内做 OCR 识别，计算开销大。
解决：能用文本版 PDF 就优先用文本版；扫描件放慢预期，先翻关键章节。

进阶技巧

换一套自己的快捷键：默认是Alt+A（切换整页翻译）、Alt+W（整页翻译）、Alt+I（输入框翻译）、Alt+S（打开侧边面板）。在浏览器快捷键管理里改成你顺手的组合。
接自己的翻译 API：在选项页的翻译服务配置里填入自己的密钥，重度使用时更稳定，内容也只发给自己信任的服务。
给特定站点设忽略规则：常逛的英文学习网站、需要保持原文的站点，单独加忽略规则，避免误触发整页翻译。
维护术语表：反复出现的专有名词、产品名加进术语表，多个页面的译文会更一致。
试试 userscript 版：不方便装扩展的环境，可以注入 dist/userscript/immersive-translate.user.js 使用油猴版。

一句话总结：沉浸式翻译的价值在于把翻译放在内容旁边，你不用离开当前页面就能读懂外文内容，网页、PDF、字幕各走各的入口。

下一步就一件事：现在装好它，打开你最近在读的那个英文页面，按一次Alt+A看效果。