VSCode重装后中文界面失效,主因是locale.json未生成或路径错误;需通过Configure Display Language命令选zh-cn(小写连字符)自动生成合法配置,禁用手动修改settings.json或错用大小写格式。

重装系统后中文语言包没恢复?先别装插件
重装系统后 VSCode 界面仍是英文,大概率不是语言包丢了,而是用户级配置路径被清空了——locale.json 文件根本不存在。VSCode 不会自动启用已安装的语言包,必须显式指定使用 zh-cn 才会加载它。
常见错误是:一打开 VSCode 就去扩展市场搜“中文”,装完发现还是英文,又手动往 settings.json 里加 "locale": "zh-cn",结果无效。这是因为 VSCode 1.70+ 已完全弃用该配置项,改了也白改。
- 打开命令面板:
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(Mac) - 输入
Configure Display Language并回车 - 若列表中没有
zh-cn,说明语言包未安装;若有但选了不生效,说明locale.json没生成或路径错
语言包必须装 Microsoft 官方版,ID 是 ms-ceintl.vscode-language-pack-zh-hans
扩展市场搜“chinese”会出现几十个结果,但只有作者是 Microsoft、名称为 Chinese (Simplified) Language Pack for Visual Studio Code 的那个才完整支持菜单、状态栏、错误提示等全部 UI 元素。其他包可能只翻译部分文本,甚至引发乱码或界面闪烁。
安装要点:
- 在扩展面板(
Ctrl+Shift+X)粘贴完整名称搜索,认准蓝勾认证和下载量 >1000 万 - 安装后右下角若弹出提示,点
Restart Now—— 注意不是Reload Window - 如果插件图标变灰,右键 →
Enable启用后再执行语言切换
Configure Display Language 命令必须选 zh-cn(小写 + 连字符)
这个命令是唯一被官方支持的入口,它会自动在正确路径下生成合法的 locale.json,内容严格为 {"locale":"zh-cn"}。任何手写、复制、大小写混用都会失败。
易错点:
-
zh_CN、zh-hans、Chinese (Simplified)、zh—— 全部不识别 -
zh-CN(大写 CN)在 VSCode 1.80+ 会被静默忽略,必须是zh-cn - 文件不能含注释、多余逗号、中文引号、BOM 头,否则整个
locale.json被跳过
重启必须彻底退出进程,否则 locale.json 不加载
Reload Window 只刷新渲染层,不会重新初始化语言环境。VSCode 只在全新启动窗口时读取 locale.json,后台残留进程会导致配置失效。
正确操作:
- Windows:右键任务栏图标 →
Exit(不是关所有窗口) - macOS:菜单栏
Code → Quit Visual Studio Code - Linux:从终端杀掉进程:
pkill -f "code --no-sandbox"或检查ps aux | grep code - 再双击图标或命令行启动,此时才会加载
locale.json
远程开发(WSL / Remote-SSH)要单独处理:本地设置不影响远程实例,得登录远程机器,在 ~/.vscode-server/data/Machine/xxx/locale.json 里补上同一行内容。



















