vscode界面中文不生效的主因是未安装microsoft官方中文语言包、未执行configure display language命令选zh-cn、或未彻底重启;三者缺一不可。需确认扩展id为ms-ceintl.vscode-language-pack-zh-hans,命令面板中手动点击zh-cn(非“简体中文”文字项),并点restart而非reload window;locale.json路径与内容必须严格匹配,且后台进程须完全退出。

VSCode 界面中文不生效,90% 是因为装错了插件或没走对激活流程——不是“装了就变”,而是必须装对 + 手动指定 zh-cn + 彻底重启三者全满足。
怎么确认你装的是 Microsoft 官方中文语言包
装错是中文失效的首要原因。VS Code 本身不含中文资源,所有翻译依赖插件提供字典,但只有 Microsoft 官方那个能覆盖菜单、设置、命令面板、错误提示全链路。
- 打开扩展面板:
Ctrl+Shift+X(Windows/Linux)或Cmd+Shift+X(macOS) - 搜索框里**完整输入**:
Chinese (Simplified) Language Pack for Visual Studio Code(注意括号、空格、大小写) - 只认发布者为
Microsoft、扩展 ID 是ms-ceintl.vscode-language-pack-zh-hans的那一项 - 别点
Chinese Language Pack、VSCode Chinese或任何带“Pro”“Menu”“Lite”的第三方包——它们只会改顶部菜单栏几个字,命令面板仍英文,还可能报Cannot read property 'translate' of undefined
Configure Display Language 命令为什么总选不对
这个命令不认“简体中文”“Chinese”“zh_CN”,只严格匹配 BCP 47 标准值 zh-cn(全小写、短横线、无空格)。输错或选错,它就静默失败,界面毫无变化。
- 按
Ctrl+Shift+P打开命令面板(不是Ctrl+P),输入Configure Display Language - 从下拉列表中**手动滚动找到并点击
zh-cn**,不是靠关键词匹配,也不是点“简体中文”文字项(那是显示名,实际值才是关键) - 弹出「是否重启窗口」时,必须点「是」——
Reload Window不会重读语言配置,无效 - 如果命令面板里根本搜不到这个选项,大概率是语言包没装成功,或者 VS Code 没加载到扩展(可尝试关掉所有窗口后重开再试)
locale.json 文件路径和内容必须精确
命令失效或切换后仍英文,直接编辑 locale.json 是最稳解法。但改错路径、写错格式、没杀干净后台进程,都会白忙活。
- 文件路径(不是
settings.json):
Windows:%APPDATA%\Code\User\locale.json
macOS:$HOME/Library/Application Support/Code/User/locale.json
Linux:$HOME/.config/Code/User/locale.json - 文件内容必须严格为一行合法 JSON:
{"locale":"zh-cn"}(无 BOM、无多余空格、无逗号、无注释) - 保存后,必须关闭所有 VS Code 窗口,并确认后台进程已退出:
Windows 查任务管理器中是否还有Code.exe
macOS 用活动监视器查Electron进程 - 改
settings.json加"locale": "zh-cn"完全无效——这个字段在那里不被识别
验证中文是否真生效,盯这三处就够了
终端、调试控制台、Git 输出、部分插件界面默认不随 locale 变,这不是汉化失败,是它们各自的语言环境独立控制。别被这些干扰判断。
- 顶部菜单栏(文件、编辑、视图…)是否中文
- 左侧活动栏 hover 文字(如“资源管理器”“搜索”“源代码管理”)是否中文
- 设置页里搜
locale,看值是否为zh-cn - 右下角状态栏会显示当前语言代码(如
zh-cn),点它也能快速切换
真正卡住人的从来不是“找不到按钮”,而是装完没点右下角的 Restart Now、命令面板里点了“简体中文”却没看清实际值是 zh-hans、或者改了 locale.json 却忘了杀掉后台 Code Helper 进程——这些细节一漏,整个流程就断在半路。











