沉浸式翻译常见故障怎么修3 类问题完整排查指南【免费下载链接】immersive-translate沉浸式双语网页翻译扩展 , 支持输入框翻译 鼠标悬停翻译 PDF, Epub, 字幕文件, TXT 文件翻译 - Immersive Dual Web Page Translation Extension项目地址: https://gitcode.com/GitHub_Trending/im/immersive-translate沉浸式翻译是一款免费的双语网页翻译扩展支持网页、PDF、EPUB 与字幕翻译。本文针对翻译按钮不出现、图标无反应、翻译报错这 3 类高频故障给出现象对照表、修复步骤和验证方法你照着做就能恢复使用。先确认症状对照这张表定位你的画面你看到的画面最可能的原因从哪查起点扩展图标没弹窗图标发灰扩展后台进程已退出管理页服务程序状态网页无翻译按钮右键也没有翻译项网站被排除或内容脚本被拦截选项页的排除网站列表点翻译后转圈提示网络错误或超时API 密钥失效或请求被网络拦截F12 的 Network 面板常见问题修复按症状对号入座翻译按钮一直没出现现象你打开网页后页面上没有翻译按钮右键菜单里也没有翻译项。可能原因当前域名在你的排除网站列表中——依据选项页排除列表里能搜到这个域名。内容脚本被网站安全策略拦截——依据F12 控制台过滤 immersive-translate 后出现报错。修复步骤打开扩展选项页从排除网站列表中移除当前域名。按 F12 刷新页面确认控制台没有 immersive-translate 相关报错。在管理页禁用扩展等 5 秒重新启用再刷新一次网页。验证方法右键菜单出现翻译为…选项、点击图标能弹出面板即算修好若问题只在某一个网站复现记下该域名备查。扩展图标点击没反应现象你点工具栏图标后没有弹窗也没有侧边栏图标呈灰色。可能原因后台服务已停止——依据管理页点服务程序打不开或打开后空白。浏览器版本过旧——依据浏览器关于页版本低于 114Chrome/Edge。另一个翻译扩展抢占点击——依据你停用其他翻译扩展后图标恢复。修复步骤打开 chrome://extensions确认沉浸式翻译处于启用状态。点击扩展卡片上的服务程序确认能打开控制台页面。若服务程序打不开禁用扩展并重启浏览器再重新启用。把浏览器升级到 114 或更新版本再试一次点击。验证方法点击图标能弹出面板且服务程序入口可正常打开即恢复正常。翻译提示网络错误或超时现象你点翻译后转圈十几秒提示请求失败或服务不可用换别的页面也一样。可能原因所选翻译服务在当前网络不可达——依据同一服务在另一台设备上也失败。自定义 API 密钥过期或额度用尽——依据你换回内置免费服务后恢复正常。代理或拦截插件拦掉了请求——依据Network 面板里该请求显示被 block。修复步骤在选项页把翻译服务临时切到内置免费服务。按 F12 切到 Network 面板触发一次翻译记录该请求的状态码。看到 401 或 403回设置页重填 API 密钥看到 429等 5 分钟再试。关闭代理与广告拦截插件再触发一次翻译测试。验证方法在任一英文页面触发整页翻译5 秒内原文下方出现中文对照即修好。环境自检逐项打勾再排查浏览器版本检查点正常是 ≥ 114Chrome/Edge或 ≥ 121Firefox异常是更低版本后台进程容易静默退出。扩展版本检查点正常是 1.33.x当前发布版为 1.33.1异常是 1.20 以下旧版直接重装最新版。站点权限扩展声明了访问所有网站定义见 dist/chrome/manifest.json。检查点正常是详情页显示可以访问所有网站异常是仅有部分站点权限对应网站翻译失效。冲突扩展检查点正常是只装 1 个翻译扩展异常是装了 2 个以上图标无响应或右键菜单重复。网络环境检查点正常是所选翻译服务站点可直接打开异常是公司/学校代理下被拦截换服务或节点后恢复。仍然没解决3 步收集日志并上报 issue在管理页点服务程序打开后台控制台复现一次问题抄下红色报错文本。截图 F12 中 Console 与 Network 面板的失败请求保留状态码。记下环境信息浏览器类型与版本、扩展版本如 1.33.1、出问题网站的域名。上报模板贴到本仓库的 Issues 区仓库用途见 README.md一句话描述问题浏览器 / 版本扩展版本复现步骤1. 2. 3.是否只在某个网站出现 域名控制台错误截图防患于未然3 个使用习惯弹出更新提示时当天升级旧版后台进程更容易静默退出。往排除列表添加域名后立刻核对一遍避免误伤你常用的网站。换到公司、学校等新网络后翻译失败先查网络再考虑重装扩展。【免费下载链接】immersive-translate沉浸式双语网页翻译扩展 , 支持输入框翻译 鼠标悬停翻译 PDF, Epub, 字幕文件, TXT 文件翻译 - Immersive Dual Web Page Translation Extension项目地址: https://gitcode.com/GitHub_Trending/im/immersive-translate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
