VSCode无官方中文帮助文档,Configure Display Language仅汉化界面元素(如菜单、命令面板),错误信息、设置项描述、Hover提示、API文档等动态内容仍为英文,需直接查阅英文官网文档。

VSCode 没有官方中文帮助文档,所谓“中文帮助”只是界面汉化后的菜单、设置项名称和命令面板文字,不是文档翻译工具。
Configure Display Language 命令不等于中文文档
执行 Configure Display Language 并选 zh-cn 后,你看到的“文件”“编辑”“调试”这些词确实变中文了,但以下内容依然保持英文:
-
Ctrl+Shift+P中输入命令后弹出的错误信息(如command 'git.commit' not found) - 设置项下方的灰色描述文字(如
files.autoSave的说明),大量新增配置项未被翻译 - Hover 提示里的类型定义、JSDoc、TS 接口签名,由语言服务提供,与 locale 无关
settings.json 或 locale.json 里加 "locale": "zh-cn" 也没用
改这两个文件只能控制 UI 字符串的显示语言,不能把动态生成的内容(比如 API 文档、错误堆栈、扩展提示)翻成中文。很多人看到设置页里英文描述就以为“汉化失败”,其实那是功能边界——语言包压根不负责这部分。
验证方式很简单:打开设置页,左侧分类标签(“用户”“工作区”)是中文,但每个配置项下面的 description 仍是英文,这完全正常,不是配置错,也不是插件没装好。
真要查中文版文档,别指望 VSCode 内置
微软官网 docs.microsoft.com/vscode/ 没有简体中文版本。社区维护的非官方翻译项目(如 GitCode 上的插件开发文档中文版)只覆盖 Extension API 等特定模块,不提供通用用户手册。
搜索“vscode 官方文档 中文”排在前面的结果多为 CSDN 博客或过时笔记,更新滞后、无权威性。实际建议就是直接看英文文档:docs.microsoft.com/en-us/vscode/ 更新及时、结构清晰,且绝大多数术语(workspace、task、debug configuration)在中文开发语境中已是通用词。
最容易被忽略的一点:很多人把“界面中文”和“文档中文”混为一谈,折腾半天 locale.json 和插件,却不知道 VSCode 根本不提供后者——这不是配置问题,是产品定位决定的。











