沉浸式双语网页翻译 2 步装好：3 个场景实测 + 5 个高频坑，完整上手指南-平芜编程栈

沉浸式双语网页翻译 2 步装好：3 个场景实测 + 5 个高频坑，完整上手指南

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

沉浸式翻译是一个装在浏览器里的双语网页翻译扩展，译文排在原文旁边，适合每天要读外文网页、论文和字幕的人。复制内容到翻译网站再贴回来，思路断掉的场景熟不熟悉？这篇带你从安装到跑通，一次讲清楚。

能力速览：网页、文档、输入三类用法一张表看懂

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

构建产物按浏览器放在dist/下，Chrome 版见 dist/chrome/，Firefox 版见 dist/firefox/，油猴版在 dist/userscript/；选项页相关页面资产在 docs/ 目录。

两步装好沉浸式翻译并验证效果

第 1 步：获取扩展。在浏览器扩展商店搜索"沉浸式翻译"直接安装；或从仓库拉取发布产物（仓库同时用于发版和跟进反馈）：

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

第 2 步：基础设置与验证。装好后打开选项页（右键扩展图标 → 选项），按顺序确认 3 项：

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

最后做一个最小验证：打开任意英文网页，按一次Alt+A，看到每段原文下排出译文，核心链路就算跑通了。

最常用的 3 个场景，按人群各取所需

开发者读英文技术文档

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

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

边界在哪：动态加载的内容可能不在首屏翻译范围内，用"翻译到页面末尾"操作或Alt+W补齐。

学生处理扫描版 PDF 论文

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

你会看到：译文跟随原文档结构输出，长文档可以按章节翻着看。

边界在哪：扫描件要在浏览器内做 OCR，首批译文明显更慢，识别准确率也会传导到译文质量，提前有预期。

普通用户看外语视频、填外文表单

怎么做：视频页开启字幕翻译，字幕以双语形式显示；表单页按Alt+I触发输入框翻译。

你会看到：看课程不用暂停查词；输入的内容同步出译文，提交前能确认表达是否准确。

边界在哪：手机号、卡号、密码这类内容默认脱敏，译文里看到的是掩码，属预期行为。

出问题时先看这里：最常见的 5 个坑

点翻译没反应：通常是页面还在加载、站点被忽略规则覆盖或当前服务不可用。等页面加载完刷新重试，到选项页检查站点规则，再换个翻译服务验证。
只翻译了页面一部分：默认只翻译一定范围内的文本以控制首屏速度，随滚动动态加载。用"翻译到页面末尾"，或按Alt+W一次性翻完。
快捷键按了没反应：默认快捷键可能被改过，或被其他扩展、系统快捷键占用。Chrome 系到扩展快捷键管理页核对，Firefox 在附加组件设置（about:addons）里管理。
译文里数字、账号变成打码：敏感信息脱敏默认开启，这类内容不会发给第三方服务。属预期行为，原文不受影响；确认安全后在选项页脱敏配置中按需调整。
扫描件 PDF 翻得很慢：扫描图片先做 OCR 再翻译，计算开销大。能用文本版 PDF 就优先用文本版，扫描件先翻关键章节。