在VSCode中安装中文语言包须通过扩展市场安装官方语言包,执行Configure Display Language命令选择zh-cn并重启生效;手动编辑locale.json或双击vsix均不可靠。

在 VSCode 中安装中文语言包的正确方式
VSCode 官方语言包必须通过扩展市场安装,不能手动下载 vsix 文件双击安装(否则可能不生效或被覆盖)。打开命令面板(Ctrl+Shift+P 或 Cmd+Shift+P),输入并选择 Configure Display Language —— 这会自动跳转到语言扩展推荐页,点击安装 Chinese (Simplified) Language Pack for Visual Studio Code 即可。
设置界面语言为中文后仍显示英文的常见原因
装完语言包不等于立刻切语言,VSCode 需要重启并显式指定生效语言。安装完成后务必执行:Ctrl+Shift+P → 输入 Configure Display Language → 选择 zh-cn → 点击提示中的 Restart 按钮。如果跳过重启,或只改了 locale.json 但没调用该命令,界面仍保持英文。
-
locale.json文件路径为~/.vscode/locales/zh-cn.json(Linux/macOS)或%USERPROFILE%\AppData\Roaming\Code\locales\zh-cn.json(Windows),但不建议手动编辑此文件 - 若使用 Remote-SSH 或 WSL,需在对应远程环境中也安装语言包并执行一次
Configure Display Language - 某些企业版或定制版 VSCode(如 VSCodium)不支持官方语言包,会始终回退到英文
多语言环境下的语言优先级与冲突处理
VSCode 按以下顺序决定最终界面语言:命令面板中 Configure Display Language 设置 > locale.json 内容 > 系统区域设置。如果系统是英文但你想局部用中文,不要依赖系统语言自动匹配——必须走命令面板手动设为 zh-cn。另外,部分插件(如 GitLens、Prettier)有自己的语言控制逻辑,它们的语言可能滞后于主界面,需单独检查其设置项中是否含 gitlens.language 或 prettier.locale 等配置。
卸载或临时切换回英文界面的方法
不需要卸载语言包,只需再次运行 Configure Display Language 并选 en,然后重启。如果误删了语言包导致无法唤出命令面板,可在终端中执行:code --locale=en(macOS/Linux)或 code --locale=en(Windows PowerShell),强制以英文启动一次,再从界面操作恢复。
注意:VSCode 1.85+ 版本起,语言包更新后可能要求重新执行 Configure Display Language 才能应用新翻译,不是 bug,是设计如此。









