VS Code 安装简体中文语言包后需手动执行 Configure Display Language 命令并重启才能生效,因插件仅提供翻译资源而不自动激活;1.70+ 版本弃用 settings.json 中的 locale 字段,仅认用户级 locale.json 文件,且远程开发需单独配置。

Configure Display Language 命令必须手动执行
装完 Chinese (Simplified) Language Pack for Visual Studio Code 插件后界面仍是英文,根本原因不是插件没装好,而是 VS Code 根本没“决定”用它。这个插件只提供翻译资源(zh-cn.nls.json 等文件),不自动激活——Configure Display Language 是唯一能触发语言切换的入口。
常见错误包括:
- 点了右下角弹窗的“是”,但后台
Code.exe进程未退出,新窗口复用旧环境 - 在设置里搜“language”改了
settings.json里的"locale",但该字段在 VS Code 1.70+ 已被弃用,改了也无效 - 命令面板里输 “change language” 或 “set locale”,根本找不到正确命令
正确做法:Ctrl+Shift+P → 输入完整命令名 Configure Display Language → 回车 → 从列表中选 zh-cn(注意:不是 zh-CN、zh_CN、Chinese)→ 点 Restart(不是 Reload Window)。
locale.json 路径和格式必须严格正确
VS Code 1.70+ 版本只认用户级 locale.json 文件,不再读 settings.json 中的 locale 字段。如果命令面板打不开、卡死或切换失败,直接编辑该文件是最稳的兜底方式。
操作要点:
- 先彻底退出 VS Code:Windows 查任务管理器杀掉所有
Code.exe进程;macOS 在活动监视器里结束Code Helper;Linux 执行killall -9 code - 定位并编辑
locale.json:- Windows:
%APPDATA%\Code\User\locale.json - macOS:
$HOME/Library/Application Support/Code/User/locale.json - Linux:
$HOME/.config/Code/User/locale.json
- Windows:
- 文件内容仅一行:
{"locale":"zh-cn"},保存为 UTF-8 无 BOM 编码(用 VS Code 自己新建保存最稳妥)
远程开发(SSH/WSL)需单独配置 locale.json
本地设成中文,远程窗口还是英文?这不是 bug,是 Remote-SSH 和 WSL 启动的是独立的 VS Code Server 实例,它读取的是远程机器上的 locale.json,和本地完全无关。
实操步骤:
- 在远程终端中确认 Server 已启动:
code --list-extensions - 进入路径:
~/.vscode-server/data/Machine/(后面可能带哈希后缀) - 在此目录下新建或编辑
locale.json,内容仍为:{"locale":"zh-cn"} - 改完后,在远程窗口执行
Developer: Reload Window(不是 reload 本地窗口)
注意:远程的 locale.json 和本地路径不同,且不继承本地设置,必须单独处理。
部分界面永远无法汉化是正常设计限制
即使 locale.json 正确、插件已启用、进程已重启,你仍会看到这些地方是英文:
- 右键菜单里的
Copy Path、Reveal in Explorer—— 由操作系统底层提供,VS Code 无法控制 - 终端标签页文字(如
Terminal 1)—— Electron 自带本地化,简体中文未覆盖全部术语 - 状态栏的
Ln 12, Col 5—— VS Code 官方至今未对这部分做完整本地化 - 第三方插件的提示、配置项(如 ESLint 报错、GitLens 设置页)—— 取决于插件作者是否内置中文支持
这些不是配置错误,也不是插件失效,而是 VS Code 架构层的明确限制。真正容易被忽略的是:你花半小时调 locale.json,却在终端里纠结 Terminal 三个字母为啥没变中文——那本来就不归它管。


















