必须安装Microsoft官方中文语言包、执行Configure Display Language命令选zh-cn、彻底重启进程,三者缺一不可;装错插件或仅Reload Window会导致界面仍为英文。

VSCode界面语言切换为中文,必须同时满足三个硬性条件:装对官方语言包、执行 Configure Display Language 命令并选 zh-cn、彻底重启进程。漏掉任一环节,界面就永远卡在英文。
认准唯一有效的语言包:Microsoft 官方 Chinese (Simplified) Language Pack
搜“中文”“汉化”大概率装错——那些叫 Chinese Menu、VSCode Chinese Pro 的第三方插件只改菜单栏几个字,命令面板、设置项、错误提示全是英文,还可能引发 Cannot read property 'translate' of undefined 报错。
- 打开扩展面板(
Ctrl+Shift+X或Cmd+Shift+X),搜索完整名称:Chinese (Simplified) Language Pack for Visual Studio Code - 发布者必须是 Microsoft,扩展 ID 是
ms-ceintl.vscode-language-pack-zh-hans - 安装后右下角弹出提示时,必须点 Change and Restart;点 Reload Window 不生效
- 若扩展图标变灰,说明被禁用,需手动启用
Configure Display Language 命令只接受 zh-cn,其他写法全无效
装完插件只是“备好翻译材料”,真正启用中文靠的是这个命令。它不校验输入,输错也无报错,只会静默维持英文界面。
- 按
Ctrl+Shift+P(或Cmd+Shift+P)打开命令面板,输入完整命令名:Configure Display Language - 从下拉列表中**严格选择
zh-cn** ——zh_CN、ZH-CN、zh、Chinese全部无效 - 选完会弹提示框,必须点 Restart;点 OK 或关掉窗口都不写入配置
- 验证是否生效:看顶部菜单栏(
文件/编辑/视图)、命令面板占位符(应为「请输入命令或搜索设置」)、设置左侧导航(用户/工作区)
命令失效时,直接手动写 locale.json 文件
命令面板卡死、输不了字、或重启后仍是英文,说明 VS Code 没成功写入配置。此时绕过 UI 层,手动编辑是最稳解法。
- 彻底退出 VS Code:Windows 查任务管理器杀光所有
Code.exe;macOS 在活动监视器结束Code Helper - 新建或编辑对应路径的
locale.json文件:
Windows:%APPDATA%\Code\User\locale.json
macOS:~/Library/Application Support/Code/User/locale.json
Linux:~/.config/Code/User/locale.json - 文件内容**严格为一行 JSON**:
{"locale":"zh-cn"}(无 BOM、无多余空格、无逗号) - 如果文件不存在,直接新建;VS Code 启动时会自动识别
真正容易被忽略的是:终端、调试控制台、Git 输出、部分插件界面默认不随 locale 变——那是它们各自的语言环境,不是 VS Code 汉化失败。盯住顶部菜单栏、左侧活动栏 hover 文字、设置里搜 locale 看值是否为 zh-cn,这三处对了,就是真汉化成功。











