沉浸式翻译不工作4 种常见故障修复完全指南附现象原因对照表【免费下载链接】immersive-translate沉浸式双语网页翻译扩展 , 支持输入框翻译 鼠标悬停翻译 PDF, Epub, 字幕文件, TXT 文件翻译 - Immersive Dual Web Page Translation Extension项目地址: https://gitcode.com/GitHub_Trending/im/immersive-translate图标点了没反应页面还是英文PDF 一打开全空白——沉浸式翻译出现以上任一状况先别急着卸载。本文覆盖 4 个故障图标无响应、页面不翻译、本地 PDF 空白、快捷键失效配 1 张对照表 5 步排查10 分钟内可完成。故障定位对照表1 分钟对号入座看到的现象最可能的原因修复章节工具栏图标灰着点不出弹窗后台服务进程background.js崩溃或被回收§图标点不动刷新后页面仍是原文无译文内容脚本未注入或站点在拦截列表里§页面还是原文本地 PDF 打开后翻译区一片空白未放行扩展读取file://本地文件§本地 PDF 空白按AltA/AltI没反应快捷键未分配或与系统、其他扩展冲突§快捷键按了没反应编号排查清单按顺序做哪步不满足就跳走打开chrome://extensions/→ 扩展卡片版本号应为1.33.2、开关应为开启 → 不满足跳 §图标点不动点击工具栏图标 → 1 秒内应弹出含翻译入口的弹窗 → 不满足跳 §图标点不动刷新页面后按AltA→ 原文下方应出现译文 → 不满足跳 §页面还是原文用浏览器打开一个本地 PDF → 翻译面板应出现内容而非空白 → 不满足跳 §本地 PDF 空白在任意输入框按AltI→ 应弹出输入框翻译窗口 → 不满足跳 §快捷键按了没反应图标点不动重载后台进程【根因】Chrome 扩展的后台服务进程崩溃或休眠扩展暂时无法激活。打开chrome://extensions/找到沉浸式翻译把开关关掉再打开或直接点该扩展卡片上的重新加载图标刷新当前页面再点一次工具栏图标图标点击应弹出菜单 → 还不行 → 重启浏览器再走一遍第 2 步。页面还是原文查注入与拦截列表【根因】内容脚本content_guard.js、content_main.js没有注入当前页面或当前站点被加进了 URL 拦截列表。打开配置页仓库内离线版为 docs/options/index.html找到 URL 拦截列表删掉当前站点按F12打开控制台过滤关键字immersive-translate看有无红色报错刷新页面按AltA观察译文是否出现原文下方应出现译文 → 还不行 → 清除浏览器缓存后刷新若仅此一个网站不翻译检查该站是否注入了严格 CSP 屏蔽扩展脚本。本地 PDF 空白放行文件访问【根因】浏览器默认拦截扩展读取file://本地文件PDF 读取链路dist/chrome/pdf/ 的index.html拿不到内容。打开chrome://extensions/找到沉浸式翻译在详情页勾选允许访问文件网址关闭并重开那个 PDF再点翻译翻译面板应显示逐段译文 → 还不行 → 换用浏览器自带 PDF 阅读器打开第三方插件 PDF 会绕过扩展的翻译入口。快捷键按了没反应核对按键分配【根因】快捷键未分配或AltA整页翻译、AltI输入框翻译等键位被系统或其他扩展占用。打开chrome://extensions/shortcuts找到沉浸式翻译确认toggleTranslatePage为AltA、translateInputBox为AltI若键位被占用改成一个未被使用的组合如CtrlShiftY按下新键位应触发对应翻译 → 还不行 → 放弃快捷键改用工具栏图标点选操作功能不受影响。进阶控制台里读三类信号控制台刷immersive-translate红色报错→F12→ 过滤关键字immersive-translate→ 判定出现net::ERR_FAILED是网络请求失败换网络刷新其他报错则回chrome://extensions/重载扩展译文出来了但排版错乱→F12→ Network 面板过滤inject.css→ 判定出现404说明注入样式失败刷新页面让样式重新加载PDF / 图片翻译卡在识别阶段→ Network 面板搜tesseract→ 判定tesseract-core-simd-lstm.wasm应加载成功加载失败则清缓存并重装扩展防再坏4 个习惯每次浏览器大版本更新后进chrome://extensions/确认开关仍开启、后台进程无异常状态每次换网络环境或迁移新机器前在配置页导出一份配置 JSON 备份某网站突然不翻译时先查 URL 拦截列表里有没有它再考虑重装每次准备重装前先核对版本号当前版本已是1.33.2则优先走上述各节不直接重装终极方案一次性重做 在chrome://extensions/点移除彻底删掉扩展清除浏览器缓存与站点数据书签保留重新安装最新版Chrome 对应 dist/chrome/ 发布产物Firefox 对应 dist/firefox/ 发布产物导入之前导出的配置 JSON恢复语言对与引擎设置按顺序验证 3 项网页翻译 → 本地 PDF → 输入框翻译全过即收尾搞定。本文只覆盖上述 4 个常见故障翻译引擎 API 配置、会员功能等更深层问题请查官方说明。来源依据本仓库dist/chrome/manifest.json、dist/firefox/manifest.json与 README 整理本仓库仅含发布产物不含源代码各步骤未在所有浏览器版本上逐一验证。【免费下载链接】immersive-translate沉浸式双语网页翻译扩展 , 支持输入框翻译 鼠标悬停翻译 PDF, Epub, 字幕文件, TXT 文件翻译 - Immersive Dual Web Page Translation Extension项目地址: https://gitcode.com/GitHub_Trending/im/immersive-translate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
