vscode设置中文界面必须同时满足三条件:安装microsoft官方简体中文语言包(id ms-ceintl.vscode-language-pack-zh-hans)、执行configure display language命令选zh-cn、彻底重启所有进程,缺一不可。

VSCode 设置中文界面不是“装个插件就完事”,必须同时满足三个硬条件:装对官方语言包、用 Configure Display Language 命令选 zh-cn、彻底重启所有进程——漏掉任一环,都会卡在英文界面不动。
装错插件是新手最常踩的坑
搜“中文”“汉化”“chinese”出来的前几条,大概率是第三方包,比如 Chinese Language Pack 或 VSCode Chinese。这些插件不维护、翻译残缺,甚至会破坏 locale.json 读取逻辑,导致命令面板乱码或报错 Cannot read property 'translate' of undefined。
- 只认唯一合法插件:
Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是 Microsoft,扩展 ID 是ms-ceintl.vscode-language-pack-zh-hans - 按
Ctrl+Shift+X打开扩展面板,输入完整名称(小写),别靠模糊搜索匹配 - 安装后右下角必须弹出 Restart Now 提示——没弹窗,说明安装失败或 VS Code 版本太低(低于 1.13)
Configure Display Language 命令只认 zh-cn
装完插件只是“备好了字典”,真正激活中文靠的是这个命令。它不接受任何变体:zh_CN、ZH-CN、Chinese (Simplified)、zh-cn(首字母大写)全都不生效,且不会报错,只会静默维持英文。
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)呼出命令面板 - 输入
Configure Display Language(注意大小写和空格,不能少字母或换词) - 从下拉列表中**明确点击**
zh-cn这一项(不是靠输入搜索,是手动点选) - 弹窗提示“是否重启窗口”,必须点 Restart,点 Reload Window 不行
手动改 locale.json 是最稳的兜底方案
命令面板打不开、点了 zh-cn 仍无效、或者远程开发(Remote-SSH / WSL)下中文不生效,都是因为 VS Code 没读到配置。此时直接编辑 locale.json 文件,绕过 UI 层,强制指定语言。
- 先彻底退出 VS Code:Windows 查任务管理器杀掉所有
Code.exe;macOS 在活动监视器里结束Code Helper;Linux 用pkill -f 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
- Windows:
- 文件内容**只能是这一行**:
{"locale":"zh-cn"}(双引号、英文冒号、无空格、无逗号、UTF-8 无 BOM 编码) - 用 VS Code 自己打开该文件编辑,保存时确认右下角状态栏显示 UTF-8,不是 GBK 或 UTF-8 with BOM
真正容易被忽略的是:终端、调试控制台、Git 输出、部分插件弹窗默认不随 locale 变——它们走各自独立的语言环境,显示英文 ≠ 汉化失败。盯住顶部菜单栏、左侧活动栏 hover 文字、设置搜索框里的 locale 项值,这三处全中文才算真生效。











