VSCode显示中文界面需安装Microsoft官方中文语言包并设置locale为"zh-cn",二者缺一不可;装错第三方插件或写错locale格式(如zh_CN、ZH-CN)均无效。

VSCode 要显示中文界面,核心就两步:装对插件 + 选对语言值。装错第三方“中文插件”或写成 zh-CN / zh_CN 都会导致不生效,不是 VS Code 本身有问题,而是配置没对上。
安装官方中文语言包(别搜“汉化”)
VSCode 的中文支持必须用微软官方语言包,名字是 Chinese (Simplified) Language Pack for Visual Studio Code,作者必须是 Microsoft。第三方插件(比如叫“Chinese Menu”或“VSCode Chinese”)只改菜单文字,不翻设置项、报错提示、命令面板,属于半汉化,容易误导。
- 按
Ctrl+Shift+X打开扩展面板,搜索Chinese (Simplified) Language Pack - 认准发布者为
Microsoft,带蓝勾认证图标 - 点击安装,完成后右下角会弹出
Restart Now提示——必须点它,不是“关闭再打开”就行
用命令面板切换语言(zh-cn 是唯一有效写法)
装完插件后不重启,或者重启后还是英文,大概率是语言没切对。Configure Display Language 命令只接受小写、连字符格式的 zh-cn,其他任何变体(ZH-CN、zh_CN、zh-CN、zh_cn)都会失败,且无报错提示,只会默默维持英文。
- 按
Ctrl+Shift+P打开命令面板 - 输入
Configure Display Language,回车执行 - 在下拉列表里选
zh-cn(注意:没有“简体中文”文字标签,只有代码) - 弹窗提示重启时,务必点
Yes,不要忽略或点取消
locale.json 文件手动覆盖(适合命令面板失效时)
如果命令面板打不开、卡死,或切换后仍无效,说明 VS Code 没读到语言配置。此时直接编辑 locale.json 是最稳的方式,它绕过 UI 层,强制指定语言。
- 先彻底退出 VS Code:Windows 查任务管理器杀掉所有
Code.exe进程;macOS 在活动监视器里结束Code Helper - 打开对应路径的
locale.json文件:
Windows:%APPDATA%\Code\User\locale.json
macOS:$HOME/Library/Application Support/Code/User/locale.json
Linux:$HOME/.config/Code/User/locale.json - 文件内容只写一行:
{"locale":"zh-cn"},保存为 UTF-8 无 BOM 编码 - 重新启动 VS Code,立刻生效
真正容易被忽略的是:VS Code 的终端、调试控制台、部分插件界面默认不随 locale 变,它们走各自独立的本地化逻辑。如果看到终端还是英文,不是汉化失败,而是正常现象——那是 shell 或调试器自己的语言环境,和 VS Code 主界面无关。


















