必须安装Microsoft官方Chinese (Simplified) Language Pack插件,执行Configure Display Language选zh-cn并彻底重启;仅装第三方插件或漏改locale、格式错误、未杀进程均会导致界面仍为英文。

VSCode中文语言包必须装 Microsoft 官方版 Chinese (Simplified) Language Pack for Visual Studio Code
只装第三方汉化插件,界面大概率还是英文——微软官方这个插件才是唯一被 VS Code 内核识别的简体中文资源。它不是“翻译补丁”,而是参与 UI 渲染的语言包,覆盖菜单、设置面板、错误提示、命令面板等全部原生界面元素。
安装后必须执行 Configure Display Language 命令并选 zh-cn,再彻底重启(不是重载窗口)。常见失败原因:只装插件不改 locale;locale.json 写错路径或格式(比如写成 {"locale": "zh-CN"} 或混入中文标点);在 Remote-SSH/WSL 环境里只本地装了插件,远程实例没同步安装。
中文文档支持依赖插件自身,不是语言包能解决的
Chinese (Simplified) 插件只管 VS Code 自身 UI,不翻译扩展功能说明、API 文档、Hover 提示、代码片段注释等内容。这些取决于各插件作者是否内置中文支持或提供独立语言包。
例如:Vetur 的 Vue 组件语法提示、ESLint 的错误码解释、Prettier 的配置项描述,默认仍是英文。部分插件(如 Vue Official)已自带简体中文 Hover 文档,但多数需靠社区维护的中文文档站或手动查译。
- 遇到
Cannot find module 'xxx'类报错时,错误信息本身不会被汉化,得看英文关键词定位问题 -
settings.json里的配置项名(如"editor.fontSize")永远是英文,不能写成中文键名 - 插件市场搜索用中文关键词(如“vue”“eslint”)比搜“vue 中文”更可靠,因为插件 ID 和元数据多为英文
中文用户容易忽略的兼容性细节
VS Code 从 1.80 版起对 locale 加载逻辑做了调整,macOS 用户尤其要注意系统语言优先级干扰:即使已正确配置 zh-cn,若系统语言设为 English,且未勾选“自动切换语言”选项,VS Code 可能仍 fallback 到英文界面。
解决方法:临时将 macOS 系统语言设为“简体中文”,重启 VS Code 后再切回英文(不影响插件生效);或确认 locale.json 文件位于用户级目录(非工作区目录),且内容严格为 {"locale":"zh-cn"}(无空格、无 BOM、无多余字段)。
另一个隐形坑:Remote Development 扩展连接 WSL 或容器时,中文语言包需在远程环境中单独安装——本地装了没用,远程实例启动后会按自己 locale 配置渲染 UI。


















