VSCode显示中文界面需三步:安装Microsoft官方简体中文语言包、执行Configure Display Language命令选zh-cn、彻底重启进程;缺一不可,且locale.json必须UTF-8无BOM编码、路径正确、内容为{"locale":"zh-cn"}。

VSCode 要显示中文界面,必须装对插件、执行对命令、重启对进程——三者缺一不可;只装插件或只改设置,99% 会卡在英文界面不动。
装 Microsoft 官方中文语言包(别搜“汉化”)
第三方插件名字带“中文”“汉化”“简体中文支持”的,一律不碰。它们不更新、不兼容新版、部分还会注入脚本。唯一有效的是:Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是 Microsoft,扩展 ID 是 ms-ceintl.vscode-language-pack-zh-hans。
- 按
Ctrl+Shift+X打开扩展面板,**严格粘贴全名**搜索,不要只输 “chinese” 或 “zh” - 认准图标带蓝白 VS Code logo + 中文“中”字,作者栏写明
Microsoft - 点安装后,右下角弹出
Restart Now—— 必须点它,Reload Window不触发语言切换 - 网络受限时可离线安装:
code --install-extension vscode-language-pack-zh-hans.vsix
执行 Configure Display Language 命令选 zh-cn
语言包只是“备好字典”,VS Code 默认仍用英文启动。真正激活中文靠的是内置命令 Configure Display Language,不是设置里点几下就能改的。
- 按
Ctrl+Shift+P打开命令面板,输入Configure Display Language(注意大小写和空格,不含“中文”二字) - 从列表中选
zh-cn—— 小写、短横线、无空格;zh_CN、ZH-CN、zh、Chinese全部无效,且无报错提示 - 点
Restart按钮,不是Reload Window;后者只刷新 UI,不重载语言环境 - 如果命令面板搜不到这个选项,基本说明语言包没装成功,或装完没彻底重启
手动编辑 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 - 用 VS Code 自己打开该文件,**只写且仅写一行**:
{"locale":"zh-cn"} - 保存为 UTF-8 无 BOM 编码(VS Code 默认就是,但用其他编辑器保存可能出错)
验证是否真生效,别被假象骗了
菜单栏、设置页、命令面板显示中文 ≠ 真生效。终端输出、调试控制台、Git 提示、部分插件弹窗天生不随 locale 变,那是它们自己的本地化逻辑。
- 唯一可信验证点是右下角状态栏:点击它,下拉菜单里显示
zh-cn才算真正加载成功 - Remote-SSH / WSL 下仍是英文?那是远程实例没配,得去远程机器的
~/.vscode-server/data/Machine/xxx/locale.json单独写一遍 - 如果点了 Restart 后还是英文,大概率是:插件装错、命令输成
Configure Language、选了zh而非zh-cn、或后台进程没杀干净
最常被忽略的其实是 locale.json 的路径和编码——写到 settings.json 里、写成 zh_CN、用记事本保存带 BOM,都会让整个配置静默失效。


















