VSCode恢复默认中文显示的核心是确保locale配置值为"zh-CN"且已安装Microsoft官方中文语言包;必须手动编辑用户级locale.json文件,内容严格为{"locale":"zh-CN"},并彻底退出重启,同时排查settings.json、工作区设置及启动参数的高优先级覆盖。

VSCode 恢复默认中文显示,核心就一条:确保 locale 配置值为 "zh-CN"(注意大小写和连字符),且中文语言包已安装——不是“卸载英文”,而是显式指定中文,并让 VSCode 读到它。
确认已安装 Microsoft 官方中文语言包
没装包,设了 locale 也白搭。必须装对扩展:
- 打开扩展面板(
Ctrl+Shift+X或Cmd+Shift+X) - 搜索
Chinese (Simplified) Language Pack for Visual Studio Code,认准发布者是 Microsoft,ID 是ms-ceintl.vscode-language-pack-zh-hans - 点 Install,安装完别点 Reload Window —— 这个操作不触发语言切换
如果之前删过或禁用了这个扩展,界面会直接回退英文,且命令面板里 Configure Display Language 可能不显示 zh-CN 选项。
手动设置 locale 为 zh-CN(1.80+ 版本唯一可靠方式)
VSCode 1.80 及之后版本已移除 Configure Display Language 命令的 UI 交互入口,即使命令面板里能搜到,选完也常无响应。必须改配置文件:
- 关闭 VSCode(务必彻底退出:Windows 查任务管理器中是否残留
Code.exe,macOS 查活动监视器中的Electron进程) - 编辑对应路径下的
locale.json文件:
Windows:%APPDATA%\Code\User\locale.json
macOS:~/Library/Application Support/Code/User/locale.json
Linux:~/.config/Code/User/locale.json - 文件内容只能是严格合法 JSON:
{"locale":"zh-CN"}(双引号、无空格、无逗号、无注释、CN大写)
错一个字符,VSCode 就静默忽略该文件,继续显示英文。
排查三处高优先级覆盖项
即使 locale.json 正确,VSCode 仍可能显示英文,因为以下配置优先级更高:
-
settings.json(用户级)里写了"locale": "en"或"locale": "zh-cn"(小写cn在新版本会被忽略,等效于未设置) - 项目根目录下
.vscode/settings.json(工作区级)含"locale"字段,它会盖掉用户级设置 - 启动时带了
--locale=zh-cn或--locale=en参数(比如快捷方式目标、shell alias、脚本里),这个参数优先级最高,删掉才生效
VSCode 不报错也不提示冲突,只按优先级取值。你看到的永远是最终结果,所以得一层层翻,不能只盯一个文件。
真正容易被忽略的是:VSCode 的 locale 设置不继承系统语言,也不随扩展启用状态自动变化;它是一条硬编码的开关,必须显式、准确、无干扰地抵达。任何大小写、路径、进程残留或参数覆盖,都会让它失效。











