沉浸式翻译常见问题排查指南：4层定位从图标无反应到翻译结果空白
沉浸式翻译常见问题排查指南4层定位从图标无反应到翻译结果空白【免费下载链接】immersive-translate沉浸式双语网页翻译扩展 , 支持输入框翻译 鼠标悬停翻译 PDF, Epub, 字幕文件, TXT 文件翻译 - Immersive Dual Web Page Translation Extension项目地址: https://gitcode.com/GitHub_Trending/im/immersive-translate沉浸式翻译Immersive Translate是一款沉浸式双语网页翻译扩展除整页翻译外还支持输入框翻译、鼠标悬停翻译、PDF / Epub 文档与视频字幕翻译。当它表现异常时你往往分不清是配置问题还是程序本身的问题。这篇文章把故障拆成安装启动 / 网站与权限 / 翻译引擎 / 特定场景四个互不重叠的层次每层都给出可执行的排查步骤照着从上到下查多数问题都能在前两层解决。 快速自查先核对这6件事在深入排查前先花两分钟确认这些最容易忽略的点扩展是否启用打开扩展管理页Chrome 地址栏输入chrome://extensionsFirefox 输入about:addons确认沉浸式翻译的开关是打开的。刷新过页面吗内容脚本是在页面加载时注入的刚安装、刚重新启用后请用CtrlR刷新再测试。快捷键是否有效按AltA看页面是否进入翻译状态这是独立于按钮的验证方式。排除列表打开扩展选项页确认当前网站没有被加入排除列表。扩展类型如果你装的是油猴Tampermonkey用户脚本版它和浏览器插件是两条安装路径需确认 Tampermonkey 本身可用且脚本处于启用状态。版本与时效在管理页查看你的扩展版本号。本仓库当前发布的版本为 1.33.1且旧版开源项目已于 2023 年 1 月归档网上过老的教程大概率不再适用。 分层排查按4层逐层定位第1层 安装与启动扩展图标点击无响应如何快速修复如何判断是这一层点击工具栏图标没有任何反应图标发灰或消失AltA也无任何效果且所有网站都如此。最可能的原因扩展被禁用或更新后后台服务MV3 的 service worker处于异常状态需要重启。修复步骤地址栏输入chrome://extensionsEdge 为edge://extensionsFirefox 为about:addons。找到沉浸式翻译确认开关已打开若已打开先关闭再重新开启相当于强制重启扩展进程。仍然无反应时重启一次浏览器再按AltA测试。如果你用的是油猴版打开 Tampermonkey 仪表盘确认存在名为 Immersive Translate: AI Web, PDF Video Translator 的脚本且已启用。注意该用户脚本头部声明了 require 外部依赖见油猴脚本文件脚本加载依赖外部网络如果脚本一直加载失败可以试试换网络环境或直接改用浏览器插件版对比。第2层 网站与权限图标正常但网页上没有翻译入口怎么办如何判断是这一层图标点开弹窗正常、快捷键有效但在某个具体网站上看不到翻译按钮、悬停翻译和右键菜单都没有而其他网站正常。最可能的原因该网站被放进了排除列表或该网站自身的安全策略干扰了脚本注入。修复步骤右键扩展图标 → 选项进入选项页检查网站排除 / 自动翻译相关设置中是否包含当前域名。将对应域名移出排除列表CtrlR刷新页面重试。按F12打开开发者工具在 Console 面板过滤immersive查看是否有脚本相关报错。若有报错把第一条错误原文记下来后续反馈要用。若只在个别网站失效且控制台无明显报错通常可以视为该站环境的限制换一个网站验证即可。第3层 翻译引擎页面能进翻译但结果空白如何换引擎对比如何判断是这一层翻译状态能开启、页面出现翻译占位但译文迟迟出不来或弹出错误提示在不同网站表现一致说明问题跟网站无关。最可能的原因当前翻译引擎的网络链路不通或该引擎需要额外的密钥 / 登录态。修复步骤点击扩展界面上方的引擎按钮切换到另一个引擎例如默认的 bing再试。确认你当前网络能直接访问所选引擎对应的服务。如果配置过自定义引擎的 API 密钥回到选项页核对密钥是否仍然有效或先切回免密钥引擎对比。长页面翻译需要一定时间可以等几秒再判断是否卡住。第4层 特定场景PDF、字幕、输入框翻译空白如何恢复如何判断是这一层普通网页翻译一切正常唯独 PDF、视频字幕或输入框翻译异常。最可能的原因这些功能依赖额外模块。例如 PDF 翻译依赖扩展自带的阅读模块仓库中 dist/chrome/pdf 目录本地文件还需要浏览器允许扩展访问文件网址。修复步骤PDF 请用浏览器标签页 扩展自带的 PDF 阅读方式打开而不是交给独立的 PDF 软件。打开本地文件时到扩展管理页为沉浸式翻译开启允许访问文件网址。扫描版 PDF 需要先 OCR 识别扩展内置了 Tesseract 引擎首次处理较慢请耐心等待片刻。输入框翻译可先用快捷键AltI单独验证与网页翻译互不影响。某个功能长期异常时可以试试卸载后重新安装最新 Release 版本。 症状对照表看到的症状最可能的原因建议操作图标点击无反应快捷键也无效扩展被禁用或需重启按第1层步骤重新启用并重启浏览器其他网站正常个别网站无入口网站在排除列表中或站点拦截注入在选项页核对排除列表F12 记录报错能进翻译状态但结果空白引擎网络问题或密钥失效切换到另一个引擎对比油猴版完全无效果脚本未启用或外部依赖未加载在 Tampermonkey 仪表盘检查脚本状态与网络仅 PDF 翻译空白未用内置阅读器或缺文件访问权限用内置 PDF 阅读方式打开允许文件网址访问输入框 / 字幕翻译不工作功能模块或快捷键未触发先用AltA、AltI分别验证再考虑重装 以上都没用时如何收集信息并反馈仓库的职责是发布 Release 版本和跟进用户反馈所以自查无效的问题值得提交反馈让维护者可以复现。提交前请按项目的Bug 报告模板准备好这些信息插件版本号必填在扩展管理页可见正在使用的翻译引擎平台与浏览器Windows / macOS / LinuxChrome / Firefox / Edge 等扩展类型浏览器插件还是油猴用户脚本出现问题的网址和可复现的操作步骤F12 控制台里记录到的第一条错误原文操作路径在项目的 Issues 区选择Bug 报告模板按上述字段填写。如果你的问题其实是使用疑问而非故障请改到讨论区提问help 类型附上问题概述和补充信息即可。整体路径就是安装启动 → 网站与权限 → 翻译引擎 → 特定场景四层每层都有独立的判断标准和编号修复步骤从上往下逐层做看到结果即可停。更多功能细节与完整安装说明请以项目 README 中链接的官方文档为准。【免费下载链接】immersive-translate沉浸式双语网页翻译扩展 , 支持输入框翻译 鼠标悬停翻译 PDF, Epub, 字幕文件, TXT 文件翻译 - Immersive Dual Web Page Translation Extension项目地址: https://gitcode.com/GitHub_Trending/im/immersive-translate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
