VSCode界面汉化仅翻译固定UI字符串,不覆盖错误信息、设置描述、Hover提示等动态内容;真正中文文档需依赖社区非官方翻译,官方文档仍以英文为主。

VSCode 没有内置的“中文文档”页面,所谓“中文帮助”实际是界面汉化后的设置页、命令面板和错误提示——它不提供 API 文档或教程类内容。
VSCode 内置帮助(如 Ctrl+Shift+P 里的命令说明)能汉化吗?
能,但仅限于语言包覆盖的 UI 字符串。比如输入 Configure Display Language 后看到的选项名、菜单栏文字、“File” → “打开文件夹”这类翻译。但以下内容不会变中文:
-
Ctrl+Shift+P中执行命令后弹出的错误信息(如command 'git.commit' not found),取决于扩展自身是否提供中文文案 - 设置项的描述文字(如
"files.autoSave": "afterDelay"这行下面的灰色说明),只有部分关键设置被翻译,大量新配置项仍为英文 - Hover 提示中的类型定义、JSDoc 注释、TS/JS 接口签名,完全由语言服务提供,与 locale 无关
想查真正的中文版官方文档,去哪找?
微软官方未发布简体中文版 docs.microsoft.com/vscode 文档。目前最接近“中文文档”的资源是社区维护的非官方翻译项目:
- GitCode 上的 VS Code 插件开发文档中文版(专注 Extension API,非通用用户手册)
- VS Code 官网右上角语言切换器点开后选“中文”,会跳转到中文版官网首页,但其中链接仍指向英文文档页
- 搜索关键词
vscode 官方文档 中文排名靠前的结果多为博客或 CSDN 整理的碎片化笔记,无权威性、更新滞后
真实建议:直接看英文文档。docs.microsoft.com/en-us/vscode/ 更新及时、结构清晰,且绝大多数术语(如 workspace、task、debug configuration)在中文开发语境中已成通用词。
为什么改了 locale.json,设置页里还是英文说明?
因为 VS Code 的语言包只翻译UI 控件名和固定字符串,不翻译动态生成的内容。例如:
- 左侧设置分类标签(“用户”、“工作区”、“扩展”)会被翻译
- 但每个配置项下方的描述文字(description)是否显示中文,取决于该配置项在源码中是否标注了
localizedDescription—— 大量新增配置项尚未补全 - 你看到的英文描述,是直接从 TypeScript 接口定义里提取的原始字符串,不是 locale.json 能控制的范围
这不是配置错误,是功能边界。别删 locale.json 或反复重装插件,没用。
真正容易被忽略的是:很多人以为“界面变中文 = 所有文字都中文”,结果在设置里看到英文描述就怀疑汉化失败。其实那部分本就不在语言包职责范围内——它从来就不是文档翻译工具。


















