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

装完语言包不等于界面变中文——locale 配置没写对、没生效,菜单可能中文化但设置页、报错信息、命令面板仍全是英文。
必须安装 Microsoft 官方 Chinese (Simplified) Language Pack for Visual Studio Code
第三方“汉化插件”或名字近似的包(如 Chinese Language Pack、VSCode Chinese)无法提供完整翻译资源,会导致部分 UI 仍是英文,甚至引发乱码或崩溃。
- 打开扩展面板:
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 文件中的 locale 字段。这个文件默认不存在,需手动创建或通过命令触发生成。
- 按
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 启动的是独立的 VS Code Server 实例,它读取的是远程机器上的 locale.json,和本地完全无关。
- 在 WSL 终端中运行:
code --list-extensions确认 VS Code Server 已启动 - 进入路径:
~/.vscode-server/data/Machine/(后面可能带哈希后缀) - 在该目录下新建或编辑
locale.json,内容仅一行:{"locale":"zh-cn"} - 保存后,在远程窗口中执行
Developer: Reload Window,不要只 reload 本地窗口
常见失效原因和验证点
右下角状态栏显示 en、设置页仍是英文、命令面板提示是英文——这些都不是“没装对”,而是语言上下文没透传或配置未命中。
- 检查是否所有 VS Code 进程都已退出(托盘图标还在就代表没关干净)
- 确认
locale.json文件编码是 UTF-8 无 BOM(用 VS Code 自己新建并保存,别用记事本) - 终端子进程(如集成终端里的
node、python报错)仍显示英文属正常,它们不受 VS Codelocale控制 - 验证是否生效:打开设置页(
Ctrl+,),看左侧导航栏是否为“用户”“工作区”,搜索框占位符是否为“搜索设置”
最易被忽略的是:Remote-SSH 和 WSL 的 locale.json 必须各自独立存在,且路径不能错;另外,zh-cn 的大小写和连字符一旦写错,VS Code 就当没这回事,也不会报错。











