必须安装 Microsoft 官方中文语言包并正确配置 locale.json 文件,否则界面无法完全中文化;第三方汉化插件无效且可能导致乱码或崩溃。

是不是以为装完语言包,界面就自动变中文了?其实不然。如果 locale 配置没写对或者根本没生效,你可能会遇到一个“半中半英”的尴尬局面:菜单可能是中文的,但设置页面、报错信息乃至命令面板,依然全是英文。
必须安装 Microsoft 官方 Chinese (Simplified) Language Pack for Visual Studio Code
这里有个关键点:务必认准官方包。市面上那些名字相近的第三方“汉化插件”(比如 Chinese Language Pack 或 VSCode Chinese),通常无法提供完整的翻译资源。结果就是部分界面仍是英文,更糟的是,它们还可能引发乱码甚至程序崩溃。
- 操作很简单:打开扩展面板,快捷键是
Ctrl+Shift+X(Windows/Linux)或Cmd+Shift+X(macOS)。 - 在搜索框里输入完整名称:
Chinese (Simplified) Language Pack for Visual Studio Code。 - 只认准发布者为
Microsoft的那一项,点击Install安装。 - 安装完成后,状态显示为
Installed即可,这时还不需要重启编辑器。
locale.json 是唯一生效配置路径,不是可选项
接下来才是真正的重点。很多人会习惯性地去修改 settings.json,加上 "locale": "zh-cn"——但这么做是无效的。VS Code 只认一个文件:locale.json。这个文件默认不存在,需要你手动创建,或者通过一个命令让它自动生成。
- 按下
Ctrl+Shift+P打开命令面板,输入并执行:Configure Display Language。 - 在弹出的选项列表中,选择
zh-cn。注意格式:必须是小写字母加连字符,写成zh_CN、Zh-cn或zh-CN都不会生效。 - 选择后,VS Code 会自动在用户数据目录下创建
locale.json文件,并写入正确内容:{"locale":"zh-cn"}。 - 最后,根据弹出的提示点击
Restart重启,或者手动执行Developer: Reload Window命令。
Remote-SSH / WSL 环境要单独配 locale.json
如果你使用 Remote-SSH 连接远程服务器,或者在 WSL 中工作,可能会发现:本地已经是中文了,怎么一连接远程,界面又变回英文了?原因在于,Remote-SSH 和 WSL 启动的是独立的 VS Code Server 实例,它读取的是远程机器上的配置文件,和本地设置完全无关。
- 首先,在 WSL 终端或 SSH 会话中运行
code --list-extensions,确认 VS Code Server 已经启动。 - 然后,进入远程机器上的特定路径:
~/.vscode-server/data/Machine/(目录名后面可能带有一串哈希后缀)。 - 在该目录下,新建或编辑
locale.json文件,内容只需要一行:{"locale":"zh-cn"}。 - 保存后,关键一步是:在远程窗口(而不是本地窗口)中执行
Developer: Reload Window命令,重新加载远程实例。
常见失效原因和验证点
当你看到右下角状态栏显示 en、设置页面仍是英文、命令面板提示也是英文时,这通常不是语言包没装对,而是语言上下文没有正确传递,或者配置没有被成功读取。
- 检查是否所有 VS Code 进程都已彻底退出。系统托盘图标如果还在,就意味着没关干净,会影响新配置的加载。
- 确认
locale.json文件的编码是 UTF-8 无 BOM。最稳妥的方法是用 VS Code 自己来新建和保存这个文件,避免使用 Windows 记事本等工具。 - 需要理解的是,集成终端里运行的子进程(比如
node或python的报错信息)显示英文是正常现象,它们的语言不受 VS Code 的locale设置控制。 - 如何验证配置是否真正生效?打开设置页面(
Ctrl+,),观察左侧导航栏是否显示为“用户”“工作区”,搜索框的占位符文字是否为“搜索设置”。
最后,最容易忽略的两个细节是:第一,Remote-SSH 和 WSL 环境下的 locale.json 必须各自独立配置,路径不能出错;第二,zh-cn 这个值的大小写和连字符格式必须严格准确,一旦写错,VS Code 会直接忽略这个配置,而且不会给出任何错误提示。
