必须执行Configure Display Language命令并选择zh-cn后重启VSCode,仅安装中文语言包不会自动切换界面语言;locale.json文件需位于用户级路径且内容严格为{"locale":"zh-cn"};工作区或远程配置可能覆盖用户设置。

为什么装了中文插件还是英文界面
只安装 Chinese (Simplified) Language Pack for Visual Studio Code 插件,VSCode 不会自动切中文——它只是提供翻译资源,不触发语言激活。你看到的英文界面,不是插件没装好,而是根本没告诉 VSCode “用哪套翻译”。常见误操作包括:点了 Install 就关掉扩展面板、点了「重新加载窗口」但没彻底退出进程、在设置里搜 language 却改了 editor.language(那是控制代码高亮语言的,和界面无关)。
必须执行 Configure Display Language 命令
这是唯一可靠的语言激活入口,不能跳过:
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)打开命令面板 - 输入完整命令名:
Configure Display Language(注意大小写和空格,别输成Change Language或Display Language) - 从下拉列表中明确选择
zh-cn(必须小写、连字符,zh-CN、zh_CN、chinese都无效) - 弹出提示后,点
Restart——不是“重新加载窗口”,是彻底重启进程
locale.json 文件内容与位置必须严格匹配
VSCode 启动时优先读取 locale.json,且只认用户级路径下的文件。如果命令面板打不开或选完仍无效,就得手动检查:
- Windows 路径:
%APPDATA%\Code\User\locale.json - macOS 路径:
~/Library/Application Support/Code/User/locale.json - Linux 路径:
~/.config/Code/User/locale.json - 文件内容必须是且仅是:
{"locale":"zh-cn"}(无空格、无多余逗号、双引号不可省略) - 别手动生成这个文件——它应由 VSCode 自己写入;若已存在但内容错误,删掉它再运行一次
Configure Display Language
工作区或远程环境可能覆盖 locale 设置
VSCode 的语言配置有优先级:远程 > 工作区 > 用户级。你本地设好了,一打开某个项目就变英文,大概率是这些地方悄悄写了冲突配置:
- 检查当前项目根目录下的
.vscode/settings.json是否含"locale": "en"或类似字段 - 连 Dev Container 或 SSH 远程时,远程端的
locale.json是独立的,需在远程会话里重新运行Configure Display Language - 临时验证方法:先
File > Close Folder,再执行命令看是否生效
终端、调试控制台、Git 输出这些区域显示英文是正常的,它们不走 locale 配置。只盯顶部菜单栏、命令面板、设置界面(Ctrl+,)是否为中文即可判断是否成功。


















