VSCode 1.85+ 版本起官方中文语言包已从扩展市场搜索索引中移除,必须输入全名“Chinese (Simplified) Language Pack for Visual Studio Code”或使用ID“ms-ceintl.vscode-language-pack-zh-hans”安装;locale.json路径、格式、编码任一错误均导致静默失效,且需彻底关闭所有VSCode进程后重启才生效。

搜不到 Chinese (Simplified) Language Pack 是正常现象
VSCode 1.85+ 版本起,微软已将 Chinese (Simplified) Language Pack for Visual Studio Code 从扩展市场搜索索引中移除。搜“中文”“汉化”“Chinese”根本不会命中官方包——不是你网络差、代理没配好,而是它被刻意隐藏了。
必须严格输入全名:Chinese (Simplified) Language Pack for Visual Studio Code(注意括号、空格、大小写),且发布者必须是 Microsoft;或者直接用 ID 安装:ms-ceintl.vscode-language-pack-zh-hans。
- 在扩展面板(
Ctrl+Shift+X)里粘贴全名搜索,别依赖关键词联想 - 命令面板中运行
Extensions: Install Extension,然后粘贴 ID 回车 - 若仍提示 “Extension not found”,说明当前扩展源未收录该 ID,需切换镜像源或离线安装 .vsix
Configure Display Language 命令搜不到或执行空白
这个命令本质是读取并编辑 locale.json。如果搜不到、点开空白、或选完没反应,大概率是底层配置异常,不是操作失误。
- 先确认插件是否真装上了:打开扩展面板,搜索
ms-ceintl.vscode-language-pack-zh-hans,看是否出现在已安装列表中 - 检查 VSCode 版本是否低于 1.70 —— 老版本不支持新版语言包格式
- 检查
locale.json所在目录权限是否异常(尤其 macOS/Linux 下曾用sudo启动过) - 此时别反复重试命令,直接手动创建/编辑
locale.json更可靠
locale.json 路径错、内容错、编码错,三者任一都会静默失败
locale.json 是唯一生效的语言开关,但它极其脆弱:路径不对、字段名写错、值格式不对、编码带 BOM,VSCode 都会直接忽略,回退到英文,且不报错。
- Windows 路径:
%APPDATA%\Code\User\locale.json(不是settings.json) - macOS 路径:
~/Library/Application Support/Code/User/locale.json - Linux 路径:
~/.config/Code/User/locale.json - 文件内容只能是这一行:
{"locale":"zh-cn"}(小写、短横线、双引号、无空格、UTF-8 无 BOM) - 写成
"zh_CN"、"zh-hans"、"Chinese"或漏掉大括号,全部无效
改完配置但界面仍是英文,大概率进程没关干净
VSCode 的语言配置只在启动时读取一次。后台残留的 Code.exe(Windows)、Electron(macOS)或 code(Linux)进程会继续使用旧缓存,新窗口也跟着加载旧配置。
- Windows:打开任务管理器,结束所有
Code.exe进程(包括后台和托盘) - macOS:用活动监视器查所有
Electron和Code Helper进程,全部退出 - Linux:终端执行
killall -9 code或pkill -f 'code' - 重启后,右下角状态栏应显示
zh-cn或「简体中文」,点击它也能快速验证
locale.json 却没关净进程,或是把 locale 字段错写进 settings.json 白忙一场。


















