必须安装microsoft官方中文语言包(id:ms-ceintl.vscode-language-pack-zh-hans),第三方汉化插件会破坏命令面板;执行configure display language命令并严格选择zh-cn(大小写、连字符均不可错),点restart而非reload window;若失败则手动创建utf-8无bom的locale.json文件,内容仅{"locale":"zh-cn"},并彻底杀掉code.exe/electron进程后重启。

必须装官方语言包,第三方“汉化插件”会破坏命令面板
装错插件是界面始终英文的最常见原因。搜索“中文”“汉化”出来的非 Microsoft 发布的插件(比如 Chinese Language Pack、VSCode Chinese)大概率会让 Configure Display Language 命令从命令面板里消失,或触发 Cannot read property 'translate' of undefined 报错。
唯一有效的插件是:Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是 Microsoft,扩展 ID 是 ms-ceintl.vscode-language-pack-zh-hans。安装后右下角弹出的 Restart Now 提示必须点——Reload Window 不会加载语言资源。
Configure Display Language 只认 zh-cn,大小写和连字符都不能错
这个命令不是选“中文(简体)”就完事,它底层只识别字符串 zh-cn。写成 zh_CN、zh-hans、Chinese、zh 全部无效,且不报错,直接回退到英文。
操作路径:
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)呼出命令面板 - 输入
Configure Display Language,**明确点击下拉列表中的zh-cn项** - 弹出提示后必须点 Yes,否则配置不写入磁盘
验证是否生效:关掉所有 VSCode 窗口,再检查任务管理器(Windows)或活动监视器(macOS)里是否还有 Code.exe 或 Code Helper 进程残留——有残留就会复用旧环境,看起来像没生效。
手动改 locale.json 是最稳的兜底方式
当命令面板打不开、列表里没有 zh-cn、或反复重启仍英文时,直接编辑配置文件绕过 UI 层,优先级最高,且不依赖插件状态。
定位并编辑 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"}(无空格、无 BOM、UTF-8 编码)。如果文件不存在,直接新建;如果存在但内容是 {"locale":"en"},删掉重写。
界面中文 ≠ 文件中文,乱码问题要单独处理
菜单变中文了,但打开含中文的文件还是乱码?这不是语言包的事,是编码不匹配。VSCode 的界面语言和文件编码是两套完全独立的机制。
排查步骤:
- 打开一个乱码文件,看右下角状态栏显示的编码(如
GBK、ISO 8859-1) - 点击该编码,选
Reopen with Encoding尝试不同编码读取 - 显示正常后,再点一次编码,选
Save with Encoding用该编码保存 - 一劳永逸:在
settings.json中加"files.encoding": "utf8"(注意是utf8,不是utf-8)
特别提醒:Windows 上新建的 .txt 文件默认是 GBK,而 VSCode 新建文件默认是 UTF-8,直接拖入就会乱码——问题不在 VSCode,而在源头编码不一致。











