沉浸式翻译不生效？8 个常见症状与自查修复步骤

沉浸式翻译不生效8 个常见症状与自查修复步骤【免费下载链接】immersive-translate沉浸式双语网页翻译扩展 , 支持输入框翻译 鼠标悬停翻译 PDF, Epub, 字幕文件, TXT 文件翻译 - Immersive Dual Web Page Translation Extension项目地址: https://gitcode.com/GitHub_Trending/im/immersive-translate这篇文章面向已安装沉浸式翻译Immersive Translate双语网页翻译扩展、但用着用着卡住的你把翻译没出来、PDF 翻不了、输入框不响应等 8 个高频问题按症状排好序跟着做就能自己完成排查不用提工单。先看你在哪一步卡住不用通读全文对照下表找到你的症状直接跳到对应章节症状你的口吻最可能原因跳转解决页面上点什么都没反应翻译开关没开或没按快捷键「翻译根本没出来」往下滚动译文就断片动态加载的网页新内容还没被翻译「滚动之后译文不见了」鼠标悬停不出提示没用默认按住 Ctrl 鼠标按下手势「悬停翻译没反应」输入框里按键没反应触发键顺序不对或该站点被默认屏蔽「输入框翻译不动」PDF 打不开或翻不了用了浏览器自带 PDF 阅读器「PDF 翻译失败」Epub 导进去没译文文件没在官方电子书阅读器里打开「Epub 导入后没翻译」译文和原文挤在一起、页面乱了目标网站的样式与译文排版冲突「译文排版错乱」设置改了一堆反而更糟缓存设置与服务器配置不同步「进阶自查」仓库说明本仓库用于发布 Release 版本并收集用户反馈不含扩展源代码具体见 README.md扩展安装包位于 dist/chrome/ 等目录默认行为快捷键、触发方式定义在 默认配置文件 中。网页翻译打开页面后没反应翻译根本没出来点扩展图标、翻页、刷新页面始终是纯原文按顺序做在浏览器地址栏按 F12 打开开发者工具确认地址栏右侧的扩展拼图菜单里能找到沉浸式翻译找不到说明安装没成功去扩展商店重装。点击扩展图标在弹出面板里确认网页翻译开关已打开。直接把光标放到页面上按快捷键AltA这是默认的切换页面翻译快捷键定义在默认配置文件的 shortcuts 字段里。如果页面是登录后的动态内容按 F5 刷新一次再按 AltA。确认修好的标志刷新后每个段落下方出现了译文且鼠标悬停段落能切换显示。滚动之后译文不见了文章类网页通常滚到哪加载到哪新加载的段落不会自动翻。先把页面滚动到底、确认正文全部加载完毕。按AltW默认的翻译整页快捷键强制把已加载内容全部翻一遍。之后若又加载了新章节再按一次 AltW 即可无需重设任何选项。确认修好的标志页面任意位置的段落下方都有译文新滚出的段落几秒内跟随出现。鼠标悬停翻译悬停没反应悬停翻译没反应沉浸式翻译的悬停翻译不是光悬停就触发的默认需要按住 Ctrl 键不放同时按下鼠标左键压在文字上约 1 秒默认配置里mouseHoverHoldKey为 Ctrl、mousePressHoldTranslateDelay为 800ms。把光标移到目标词句上。按住 Ctrl 不放同时按下鼠标左键并保持约 1 秒。若仍无提示打开扩展选项页仓库中对应 选项页代码 实现的界面把悬停触发键改成你顺手的一个键如 Alt或把按住时间调长。 提示代码块、公式和带notranslate标记的元素不参与悬停翻译属正常行为。确认修好的标志按住 Ctrl 压住词句约 1 秒后词句上方弹出译文提示框。输入框翻译按了键没反应输入框翻译不动默认触发方式是组合键 三连空格很多人卡在这一步在网页的输入框聊天框、评论框等内先输入好原文。直接按AltI默认的翻译输入框快捷键或按开始触发键/默认后快速连按 3 次空格触发翻译。若目标站点是飞书、Lark、Notion、Figma 等默认配置里已把它们列入输入翻译屏蔽名单该场景下不工作属预期请直接在外部工具中翻译后粘贴。确认修好的标志触发后输入框内的原文被替换为译文或按你设置的模式以原文保留 译文方式显示且可直接发送。文件翻译PDF 与 Epub 加载失败PDF 翻译失败扩展的 PDF 翻译依赖官方 PDF 阅读器而不是浏览器自带的 PDF 查看器默认配置中 PDF 场景匹配的是官方阅读器域名。打开沉浸式翻译扩展面板选择翻译 PDF入口或在浏览器中打开官方 PDF 翻译页面。在官方阅读器里加载你的 PDF 文件。等待首页译文出现再逐页翻看大文件几百页前几页生成较慢属正常现象。⚠️ 注意扫描版 PDF 里没有可选择的文字层任何翻译工具都拿不到原文需要先做一次 OCR 把扫描件转成可复制文本的 PDF再重新加载。确认修好的标志PDF 每一页的段落旁出现译文页码切换后译文跟随刷新。Epub 导入后没翻译同样走扩展面板的翻译 Epub入口把 .epub 文件拖进官方电子书阅读器阅读器场景在默认配置中由isEbook规则接管。导入成功后先在目录里点进任意一章确认正文以双语模式渲染。若目录正常但个别章节无译文重新加载该书再试一次。确认修好的标志任意章节正文下方都有译文翻页后译文保持。样式展示乱版、重叠、难读译文排版错乱某些网站长表格、卡片式布局、窄侧栏会把译文挤出原文区域。按以下步骤收敛打开扩展选项页切换到样式/显示相关设置把显示模式在双语对照与仅译文之间切换先看哪种模式下页面最整齐。若只是某一个站点乱用选项页里的自定义样式入口追加一小段 CSS只修这一处例如让译文容器自动换行/* 让译文跟随原文换行避免溢出 */ .immersive-translate-target-wrapper { word-break: break-word; }改完保存后回到出问题的页面按 F5 刷新验证无效就删除这段 CSS 恢复原状不要反复叠加多段样式。确认修好的标志问题页面译文与原文各占一行、不互相覆盖其他页面显示不受影响。进阶自查看扩展日志复杂问题点了没反应、控制台报红直接看日志最快Chrome / Edge地址栏输入chrome://extensions回车Firefox输入about:addons回车。找到沉浸式翻译开启页面顶部的开发者模式。在该扩展卡片上点击服务程序Chrome/Edge或背景页Firefox在打开的控制台里找红色报错记下第一条错误信息。排除扩展冲突浏览器自带翻译或其他翻译类扩展会与沉浸式翻译抢占同一块文本节点默认配置里就内置了 Chrome/Edge 内置翻译的冲突检测。把浏览器自带翻译功能和其他翻译插件全部禁用刷新页面再试一次多数时好时坏的问题到此就消失了。重装扩展以上都无效时的兜底在扩展管理页卸载沉浸式翻译 → 完全退出浏览器 → 从官方渠道重新安装最新版当前发布线为 1.30.x见默认配置文件中的releaseVersion→ 按引导重新配置翻译服务。卸载重装会清空本地设置属于不可逆操作动手前想清楚。还是不行提交反馈本仓库正是官方收集用户反馈的渠道通过 Issues 跟进按 README.md 的说明到项目仓库的Issues页面提交新 Issue 即可。提交时请一次性附全这些信息能大幅缩短定位时间浏览器名称与版本如 Chrome 126扩展版本号扩展管理页可见出问题页面的完整 URL问题截图含扩展弹出面板状态更佳复现步骤打开哪个页面 → 做了什么操作 → 期望发生什么、实际发生了什么控制台第一条红色报错文本按上面看扩展日志的方法获取把这篇文章的症状速查表留在手边下次再卡住时照着跳一步就能定位。如果觉得实用欢迎点赞收藏方便日后快速查阅。【免费下载链接】immersive-translate沉浸式双语网页翻译扩展 , 支持输入框翻译 鼠标悬停翻译 PDF, Epub, 字幕文件, TXT 文件翻译 - Immersive Dual Web Page Translation Extension项目地址: https://gitcode.com/GitHub_Trending/im/immersive-translate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考