插件市场页面翻译不了？用 vscode-translator 直抓 WebView 文本：VSCode 插件市场详情页默认英文，因官方不翻译 extension description，右键翻译无效是因仅支持文本文件且 WebView 受沙箱限制；vscode-translator 绕过限制直接抓取文本节点，支持全页双语翻译、离线可用，安装重启后点击右上角 ? 图标即可启用。
插件市场页面翻译不了？用 vscode-translator 直抓 WebView 文本
VSCode 插件市场详情页默认英文，不是插件没汉化，而是官方不翻译 extension description —— 这部分由开发者维护，多数人压根没配 package.nls.zh-cn.json。右键“Translate to Chinese”无效，因为它是为文本文件（.md、.txt）设计的，对插件页这种 Electron WebView 渲染的沙箱页面无权访问 DOM。
vscode-translator（作者 YunYouJun）是目前唯一绕过限制的方案：它不依赖注入脚本，而是直接遍历页面文本节点做翻译，支持标题、描述、更新日志、评论区全量覆盖，结果本地缓存，离线可用。
- 安装后重启 VSCode，任意插件页右上角会出现
?图标，点一下即整页双语对照 - 关闭其他翻译插件（尤其
Auto Translate和DeepL Translate），它们会抢 DOM 控制权导致失效 - 遇到 SVG 内文案未翻（如图标旁说明文字），可手动选中 → 右键 →
Translate selection - 部分 React 渲染的插件页有约 500ms 延迟，别急着关页面，等半秒再看
代码注释翻译总把 userId 翻成“用户ID”？关掉 detect source language
像 const userId = getUid() 这种混合写法，开启自动源语言检测后，插件容易把 userId 当作英文单词处理，破坏变量语义。Caiyun Translator 和 Comment Translate 都默认开这个选项，必须手动关掉。
- 在设置里搜
detect source language，设为false -
commentTranslate.source显式设为"en"，commentTranslate.targetLanguage设为"zh-CN"，避免插件瞎猜 - 长注释超 500 字触发
context too long错误？缩小选区或拆成两句再译 - 注意：目标语言填
zh（不是zh-cn），某些插件（如rokoroku.vscode-japanese-translator）会拒掉zh-cn并静默回退
悬浮翻译响应慢或不触发？检查 hover 启用链和语法范围识别
悬停翻译（如 Translate Dict、Quick Translate）依赖两个关键环节：编辑器 hover 功能开启 + 插件自身 hover 开关打开。任一环节断掉，就完全没反应。
- 确认全局
editor.hover.enabled为true - 查插件专属配置项，例如
commentTranslate.hover.enabled或translateDict.hoverEnabled，必须显式启用 - 组合词（如
devDependencies）无法识别？手动选中Dependencies部分再悬停 - 翻译错位（比如注释翻译显示在上一行）？说明插件没正确解析 TextMate 语法范围，临时禁用其他高亮类插件排查干扰
界面汉化后插件页还是英文？locale 和语言包必须同时生效
只装 MS-CEINTL.vscode-language-pack-zh-hans 不够，只改 settings.json 里的 "locale": "zh-cn" 也不够。二者缺一不可，且必须重启——不是重载窗口，是彻底关闭再打开。
- 命令面板执行
Configure Display Language→ 选zh-cn→ 点Restart，比手动改 JSON 更可靠 - 若命令面板无此选项，直接编辑
locale.json（Windows 在%APPDATA%\Code\User\locale.json），内容只能是{"locale":"zh-cn"}，英文符号一个都不能错 - Remote-SSH / WSL 环境下，语言包要分别在远程机器上也安装一次，本地装了没用
- 菜单汉化不全属正常（官方覆盖率约 85%），补全可用
Chinese Menu或vscode-zh-hans-menu，但别和主语言包冲突
真正卡住人的从来不是翻译不准，而是 WebView 沙箱、ARM 架构二进制缺失、hover 链路中断、locale 配置错位这四类底层机制问题。每个环节都得单独验证，漏一个就白调。
