VSCode 显示中文界面必须三步:安装 Microsoft 官方简体中文语言包、执行 Configure Display Language 命令并选 zh-cn、彻底关闭所有进程后全新启动;任一缺失或操作错误均导致英文界面。

VSCode 最新版本(截至 2026 年 8 月)要显示中文界面,必须完成三件事:装对插件、执行正确命令、彻底重启进程;跳过任意一步,界面都会保持英文。
安装 Microsoft 官方中文语言包
第三方“汉化插件”或名字带“中文支持”“VSCode Chinese”的扩展一律不碰——它们不更新、不兼容、可能注入脚本。只认一个:
- 在扩展面板(
Ctrl+Shift+X)搜索完整名称:Chinese (Simplified) Language Pack for Visual Studio Code - 发布者必须是 Microsoft,ID 必须是
ms-ceintl.vscode-language-pack-zh-hans - 安装后右下角会弹出提示,但不要点“Reload Window”——它不触发语言切换
执行 Configure Display Language 命令选 zh-cn
语言包只是翻译字典,真正开关是内置命令 Configure Display Language。这个命令不会自动运行,也不出现在菜单里:
- 按
Ctrl+Shift+P打开命令面板 - 输入并执行
Configure Display Language(注意大小写和空格) - 从下拉列表中严格选择
zh-cn(不是zh_CN、zh-CN、Chinese,也不是界面上显示的中文文字项) - 弹窗提示后必须点 Restart,不是“重新加载窗口”
手动编辑 locale.json 是最稳兜底方案
如果命令面板打不开、列表没 zh-cn、点了 Restart 还是英文,说明语言包未加载或进程残留,直接改配置文件更可靠:
- 先关闭所有 VS Code 进程(Windows 查任务管理器里的
Code.exe,macOS 查活动监视器里的Electron) - 定位并用 VS Code 自己打开:
%APPDATA%\Code\User\locale.json(Windows)、~/Library/Application Support/Code/User/locale.json(macOS)、~/.config/Code/User/locale.json(Linux) - 文件内容必须是且仅是:
{"locale":"zh-cn"}(UTF-8 无 BOM,不能有注释、空格、逗号、单引号) - 保存后全新启动 VS Code,不要复用旧窗口
插件界面仍是英文?这不是设置失败
VS Code 主界面(菜单栏、侧边栏、命令面板、设置页)能完全汉化,但插件自身是否显示中文,取决于它有没有提供 package.nls.zh-cn.json 并调用 vscode.env.language:
- GitLens、Settings Sync 等插件支持中文,装完 locale 就生效
- Prettier、ESLint、Python 扩展等多数只提供英文字符串,改 locale 无效
- 插件详情页里的设置项标题若仍为英文,说明该插件未做本地化,重装或改配置没用
- Remote-SSH / WSL 环境需在本地和远程两端都安装语言包并分别执行
Configure Display Language
最容易被忽略的是“彻底关进程”——很多人点了 Restart 又立刻开新窗口,后台 Code.exe 或 Electron 还在跑,locale.json 根本没被读取。关干净再启动,才是唯一稳解。


















