vscode插件市场默认不显示中文说明是因为官方cdn仅提供英文元数据,且vs code不内置翻译服务;需安装extension translate插件实现中文说明显示,或直接查阅插件官方中文文档。

插件市场默认不显示中文说明的原因
VSCode 插件市场(Extensions view)里,extension pack 或单个插件的描述文字默认走的是 VSCode 官方 CDN 的英文元数据,即使你系统语言设为中文、VSCode 显示语言是 zh-cn,也不代表插件详情页自动翻译。这不是 bug,而是设计:VS Code 本身不提供插件描述的实时翻译服务,所有文案由插件作者上传的 package.json 中的 description 和 keywords 字段决定——多数作者只填了英文。
如何让插件列表显示中文说明(实操路径)
目前唯一可靠的方式是安装支持多语言本地化的插件,并依赖其提供的中文翻译包。主流做法只有以下两种:
- 安装
vscode-language-pack-zh-cn(官方语言包)→ 它只翻译 VS Code UI,**不翻译插件说明**,别指望它起作用 - 安装第三方插件
Extension Translate(作者:jerry1024)→ 它会在插件列表右侧加一列「中文说明」,靠爬取扩展市场的中文社区翻译或缓存已有译文 - 手动修改插件的
package.json(仅限已安装插件)→ 修改node_modules/xxx/package.json中的description字段,但每次更新插件会被覆盖,不推荐
推荐直接装 Extension Translate,启用后重启 VSCode,插件面板会多出一列「中文说明」,点击「刷新」按钮可拉取最新翻译。
为什么有些插件中文说明显示为空或乱码
常见原因有三个:
-
Extension Translate没有收录该插件的中文翻译 → 查看其 GitHub 仓库的translations/目录,确认是否有对应插件 ID 的 JSON 文件 - 插件 ID 格式异常,比如含特殊字符或大小写混用(如
esbenp.prettier-vscode写成Esbenp.Prettier-vscode)→ 翻译匹配失败 - VSCode 启用了代理但
Extension Translate的请求被拦截 → 检查开发者工具 Console 中是否报net::ERR_CONNECTION_REFUSED类错误
遇到空值,可以去该插件的 GitHub 页面搜 README.zh-CN.md,复制粘贴到本地 package.json 临时应急,但别忘了更新时重做。
替代方案:用命令行查中文文档更靠谱
对关键插件(比如 ms-python.python、ms-vscode.vscode-typescript-next),与其依赖翻译插件,不如直接查作者维护的中文文档:
- 打开插件主页 → 点「Visit Homepage」→ 多数主流插件(如 Prettier、ESLint、Python)都有独立中文站或 README 中文版
- 在终端运行:
code --list-extensions | grep python找出已安装插件,再针对性搜索「插件名 + 中文文档」 - VSCode 内置命令
Developer: Toggle Developer Tools→ Console 输入JSON.parse(document.querySelector('body').dataset.extensionId)可快速定位当前插件 ID,方便搜索
翻译永远滞后,而插件作者写的中文 README 通常更准确、更新更及时。别把「列表显示中文」当成目标,把「快速定位到权威中文说明」当成目的,反而更省时间。











