沉浸式翻译故障排查翻译不生效、样式错乱、文件打不开的完整自助指南【免费下载链接】immersive-translate沉浸式双语网页翻译扩展 , 支持输入框翻译 鼠标悬停翻译 PDF, Epub, 字幕文件, TXT 文件翻译 - Immersive Dual Web Page Translation Extension项目地址: https://gitcode.com/GitHub_Trending/im/immersive-translate沉浸式翻译是一款支持网页双语对照、输入框翻译、鼠标悬停翻译以及 PDF、Epub、字幕和 TXT 文件翻译的双语网页翻译扩展。当你遇到沉浸式翻译不生效、译文缺失或截断、译文与原文重叠、文件翻译报错等问题时可以按本文的症状分组对照自查从现象出发一步步缩小范围快速恢复扩展的正常使用。 快速自检先用 4 步判断问题属于哪一类排障前花一分钟走一遍下面的分诊流程可以避免在错误的方向上浪费时间确认扩展装好且启用浏览器工具栏能看到沉浸式翻译图标、点击能打开菜单。图标缺失或菜单打不开直接跳到配置与兼容性一节。换一个简单网页测试打开一篇短英文文章触发翻译。其他网页正常说明是特定网站的问题所有网页都不行说明是扩展本身或翻译引擎的问题。检查翻译引擎确认当前选用的翻译服务已正确配置API 密钥有效、配额未用尽。引擎配置有问题时任何页面都会翻译不生效。看一次控制台报错按 F12 打开开发者工具的 Console 面板触发一次翻译看是否出现与扩展相关的红色报错。有报错就按自助诊断手段一节处理。如果你的场景是PDF/Epub 文件翻译跳过网页相关条目直接看文件翻译报错或排版错乱。 按症状排障从你看到的现象入手网页翻译完全不生效现象点击图标触发翻译后页面文字没有任何变化或只有短暂加载动画。常见原因引擎未配置好或未选对、扩展在该网站被单独禁用、与其他翻译类扩展互相覆盖。排查步骤先换一个免密钥或已配置好的引擎重新触发翻译。在扩展的网站设置中确认当前站点没有被单独禁用或加入屏蔽规则。暂时禁用其他翻译类扩展只保留沉浸式翻译。验证是否修复刷新页面后再次触发原文下方或侧栏取决于你选择的翻译模式出现稳定译文即恢复。翻译结果缺失、截断或只出一部分现象长页面只翻译了开头部分或某几段译文突然断掉、句子不完整。常见原因页面内容是懒加载或无限滚动未加载的内容不在翻译范围内译文超过了单次请求的长度上限。排查步骤先把页面从头滚动到尾让全部内容加载出来再重新触发翻译。对特别长的页面不妨改用划词/选中翻译的方式对关键段落分批翻译。若整句被拦腰截断换一个处理能力更强的引擎再试。验证是否修复重新触发后原先缺失的段落出现完整译文且句子结尾没有省略号式的断裂。译文与原文重叠、错位现象译文压在原文上或表格、卡片类区块里的译文位置明显错位。常见原因目标网站的样式与译文插入节点发生冲突少数情况下是扩展样式版本过旧。排查步骤把翻译显示样式换一种如从块状换成其他对照模式刷新对比效果。确认扩展已更新到最新版本样式冲突类问题在新版本中经常被修复。熟悉 CSS 的话可以借助设置中的自定义 CSS 项仅针对该站点追加覆盖规则/* 沉浸式翻译自定义 CSS修正译文与原文重叠 */ .immersive-translate-target { display: block !important; margin-top: 4px !important; }验证是否修复刷新页面检查几处典型的错位区块译文应与原文上下排列且不再互相遮挡。注入样式的类名可参考仓库中的 注入样式文件。悬停翻译或输入框翻译不触发现象鼠标划过单词没有弹出提示或在输入框里看不到翻译入口。常见原因对应功能开关未打开悬停位置不满足触发条件输入框属于不受支持的类型如密码框、富文本编辑器。排查步骤在设置中确认鼠标悬停翻译输入框翻译等开关已启用。悬停时把鼠标稳定停在单词上稍等片刻快速划过通常不会触发。换一个普通文本输入框测试确认当前输入框本身是否在支持范围内。验证是否修复在纯文本页面上悬停一个英文单词提示框能稳定弹出即恢复。文件翻译PDF/Epub报错或排版错乱现象打开文件时提示无法解析或翻译后段落错位、目录丢失。常见原因文件带加密/DRM 保护扫描版 PDF 没有文字层文件过大导致处理中断。排查步骤先确认文件本身可正常打开、无加密限制带 DRM 的电子书通常无法翻译。扫描版 PDF 需要先做 OCR 得到文字层扩展无法直接翻译图片文字。几百页的大文件建议先只翻译前几章确认流程正常后再整体处理。验证是否修复换一个无加密的小文件能正常打开并出译文说明原文件就是问题所在排版类问题可尝试切换文件内显示模式后再对比。⚙️ 配置与兼容性环境限制集中在这一节看浏览器版本不兼容怎么办现象安装后扩展闪退、菜单空白或在某些页面完全无反应。简析扩展依赖较新的浏览器能力浏览器过旧是最常见的环境问题。排查步骤将浏览器更新到较新版本后重启浏览器。仍无效时新建一个干净的浏览器用户配置文件安装扩展排除本地数据损坏。验证是否修复新配置文件中扩展菜单正常打开、翻译正常触发即可换回原配置逐步排查。多个翻译扩展互相冲突怎么办现象两个翻译扩展共存时译文忽隐忽现或格式混乱。排查步骤在扩展管理页只保留沉浸式翻译禁用其余翻译类扩展。刷新页面复测确认恢复后再逐个重新启用其他扩展定位具体冲突项。验证是否修复禁用冲突扩展后译文稳定出现冲突关系即确认此后按需保留其一即可。网站 CSP、DRM 等环境限制现象仅在个别网站失败且控制台提示脚本或内容策略相关报错。简析网站启用了严格的内容安全策略CSP可能限制翻译脚本的运行DRM 保护的文件同理无法处理。排查步骤打开无痕窗口并允许该扩展在无痕模式下访问在目标网站测试。无痕下正常而常规窗口异常多半是你本地的其他扩展或设置干扰可对照排查。若确认是网站 CSP 限制这属于站点侧问题记录报错信息后走求助通道。验证是否修复无痕窗口测试通过即完成定位CSP 限制本身无法在本地绕过只能等待扩展新版本兼容或向项目方反馈。 性能与大文件慢、卡、超时怎么处理翻译明显变慢或卡住现象短段落也要等很久或长页面翻译时浏览器明显变卡。排查步骤先用一小段文字计时短文本也慢问题在引擎侧限流、配额不足或网络波动可稍后重试或换引擎。短文本正常、长页面慢属于请求量大可分批翻译或换响应更快的引擎。浏览器整体卡顿大量标签页、大文件已打开时先关闭无关页面再重试。验证是否修复短段落翻译恢复到秒级响应即排除了引擎与网络问题。大文件翻译超时或中断现象处理大 PDF/Epub 时中途停止、页面卡死。排查步骤减少同时在浏览器中打开的大文件和重网页把内存让给文件处理。按章节分段翻译确认每段都正常后再继续下一段。验证是否修复分段模式下每段都能完整出译文说明是资源不足而非文件损坏。 自助诊断手段自己动手查的三件工具看扩展自己的日志打开浏览器扩展管理页启用开发者模式。找到沉浸式翻译点击背景页或服务工作线程在控制台查看运行日志与报错输出。看页面控制台的报错在问题页面上按 F12 打开开发者工具切到 Console 面板。触发一次翻译留意与扩展相关的红色报错截图或复制文本后续反馈时直接附上。备份配置与干净重装如果设置页提供了数据导入/导出入口先把当前配置备份一份。再把出问题的配置项恢复默认或整体重置后重新配置关键项。仍无法解决时做干净测试卸载扩展 → 清除残留数据 → 从官方渠道重装最新版本。 求助通道反馈前把这些信息备齐提交反馈时的最小信息清单浏览器类型与版本扩展版本号出问题的网站 URL文件翻译则注明文件类型与大致页数问题截图或短视频一句话复现步骤例如打开某站点 → 点击翻译图标 → 无译文控制台报错文本如有到哪里反馈本仓库仅用于发布 Release 版本并收集和跟进用户反馈不包含沉浸式翻译的源代码详见 README.md。问题反馈请提交到项目的官方 Issues 页面功能与安装相关的问题可查阅沉浸式翻译的官方文档仓库中打包的 选项页面 也可作为了解扩展设置项的参考。走完上面的自检流程后多数问题都能落到安装与环境引擎配置网站兼容三层中的某一层对症处理即可。如果按步骤排查后仍无法解决把最小信息清单整理好再提交反馈会大大加快定位速度。【免费下载链接】immersive-translate沉浸式双语网页翻译扩展 , 支持输入框翻译 鼠标悬停翻译 PDF, Epub, 字幕文件, TXT 文件翻译 - Immersive Dual Web Page Translation Extension项目地址: https://gitcode.com/GitHub_Trending/im/immersive-translate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考