必须安装microsoft官方中文语言包、执行configure display language命令选zh-cn并彻底重启,三者缺一不可;第三方插件无效且可能引发乱码,手动改配置或仅重载窗口均不生效。

VSCode 中文界面不是靠改 settings.json 里的某个字段就能生效的,必须走官方语言包 + Configure Display Language 命令 + 彻底重启这一套组合流程。其他任何“手动写 locale.json”“加启动参数 --locale=zh-cn”“在设置里搜 locale 下拉选”等旧方法,在 2026 年最新版中均已失效或不可靠。
必须安装 Microsoft 官方中文语言包
这是整个流程的前提,没有它,后续所有操作都无效。第三方汉化插件可能造成菜单错位、右键乱码甚至命令面板崩溃。
- 按
Ctrl+Shift+X打开扩展面板,搜索Chinese (Simplified) Language Pack for Visual Studio Code - 只认作者是
Microsoft、ID 是ms-ceintl.vscode-language-pack-zh-hans的那一项(带蓝勾认证) - 安装后右下角会弹提示,但此时界面仍是英文——这正常,语言包只是“备好字典”,还没被激活
- 别点“重载窗口”,也别关再开,等弹窗出现
Restart Now再操作
必须用命令面板执行 Configure Display Language
这个命令才是真正的开关,它会自动生成合法路径下的 locale.json 文件,并写入 {"locale":"zh-cn"}。手写配置、改 settings.json、用命令行参数启动,全都不起作用。
- 按
Ctrl+Shift+P(不是Ctrl+P)打开命令面板 - 输入
Configure Display Language,从列表中选择该项 - 在弹出的语言列表中**必须选
zh-cn**(小写、带短横线;zh、zh_CN、Chinese (Simplified)都无效) - 点击
Restart—— 注意不是Developer: Reload Window,后者不会重新读取语言配置
验证是否真生效,别被假象骗了
重启后只看三个地方:顶部菜单栏(文件/编辑/视图)、命令面板提示(请输入命令或搜索设置)、设置界面左侧导航(用户/工作区/扩展)。这三处是中文,才算成功。其他地方如调试控制台、终端输出、插件弹窗仍为英文,属于正常现象——它们依赖各自插件或系统工具链的本地化能力,和 VSCode 界面语言无关。
- 如果只有菜单变中文,但右键菜单、设置项仍为英文,大概率是装了非官方插件或版本不匹配
- 如果设置里搜
display language出现可选下拉框,说明你当前 VSCode 版本已支持该 UI 入口,但仍建议优先走命令面板流程,更稳定 - 远程开发(SSH / WSL / Containers)场景下,需在远程环境也安装同款语言包,否则远程窗口仍显示英文
最容易被忽略的一点:语言包和 Configure Display Language 命令之间存在强耦合。哪怕你已经装了包,只要没执行这条命令,VSCode 就不会生成或更新 locale.json;反过来,没装包就执行命令,VSCode 会静默失败,界面毫无变化。两者缺一不可,且顺序不能颠倒。











