vscode 中文界面需安装官方中文语言包并重启进程——必须安装 microsoft 发布的 ms-ceintl.vscode-language-pack-zh-hans 插件,执行 configure display language 命令选 zh-cn 并 restart,或手动写入 {"locale":"zh-cn"} 到 locale.json。

VSCode 要真正显示中文界面,只装插件不行,必须让 locale 配置生效且进程彻底重启——这是 2026 年最新版(v1.118)的硬性要求,任何“重新加载窗口”或改 settings.json 都无法替代。
安装 Microsoft 官方中文语言包(认准 ID 和发布者)
第三方名字带“中文”“汉化”的插件一律跳过,它们不更新、不兼容、甚至干扰命令面板。唯一有效的是:
- 扩展名:
Chinese (Simplified) Language Pack for Visual Studio Code - 作者必须是 Microsoft,插件 ID 是
ms-ceintl.vscode-language-pack-zh-hans(小写,带连字符) - 按
Ctrl+Shift+X搜chinese(小写),只点那个带蓝勾认证、下载量超千万的官方包 - 装完右下角弹出 Restart Now 提示时,必须点它——点“重新加载窗口”无效,
Code.exe进程没退出,后续所有操作都白搭
执行 Configure Display Language 命令并严格选 zh-cn
这个命令不是“切换语言”的快捷入口,而是唯一能触发 locale 初始化的开关。输错就卡死,搜不到就说明语言包根本没装成功。
- 按
Ctrl+Shift+P打开命令面板,**必须完整输入**:Configure Display Language(C 和 D 大写,中间空格,结尾无标点) - 列表里只认
zh-cn(全小写 + 连字符),zh_CN、ZH-CN、Chinese全部无效,且不会报错,只会静默失败 - 选完弹出“是否重启窗口”,必须点 Restart,不是 Reload Window
- Windows 用户请打开任务管理器确认所有
Code.exe进程已结束;macOS 用户检查活动监视器里的Code Helper
手动写入 locale.json 是最稳的兜底方式
当命令面板打不开、公司内网屏蔽扩展市场、或反复切换仍无效时,直接编辑 locale.json 绕过 UI 层所有逻辑,成功率接近 100%。
- 先彻底退出 VS Code(确保无残留进程)
- 找到对应路径并新建/编辑
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,立刻生效(即使没装语言包也能临时变中文,但长期使用仍建议补装官方包)
验证是否真生效:只看这三处,其他全是干扰项
终端、调试控制台、Git 输出、部分插件界面默认不走 VS Code 的 locale 配置,它们显示英文是设计如此,不是配置失败。
- 顶部菜单栏:文件、编辑、视图、终端 → 必须全中文
- 命令面板提示:按
Ctrl+Shift+P后,输入框上方是否显示「请输入命令或搜索设置」 - 设置页面左侧导航栏:是否为「通用」「编辑器」「工作台」等中文标签
这三处全中,才算完成;其余区域英文,不用管。











