VSCode界面不中文的最常见原因是装错第三方插件;必须安装Microsoft官方“Chinese (Simplified) Language Pack”,执行“Configure Display Language”选“zh-cn”,并彻底重启生效。

装错插件是界面不中文的最常见原因
搜“中文插件”“汉化包”“VSCode Chinese”大概率点进第三方扩展,比如 Chinese Menu 或 VSCode Chinese Pro,它们只改顶部菜单栏几个字,settings.json 里搜 locale 仍显示 "en",命令面板、错误提示、设置页全是英文,还可能报 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打开扩展面板,搜索框里**完整粘贴**该名称(注意括号、空格、大小写) - 只点图标是蓝白 VS 标志、署名 Microsoft 的那个,点击
Install - 安装完右下角弹出提示时,**必须点
Restart Now**;点Reload Window不触发语言切换
Configure Display Language 命令只认严格小写的 zh-cn
语言包只是把翻译字典放进了 VS Code,但默认仍用英文——得靠 Configure Display Language 命令告诉它“请用简体中文”。这个命令不接受任何变体,输错或选错就静默失败。
- 按
Ctrl+Shift+P打开命令面板(不是Ctrl+P),输入并执行Configure Display Language - 在弹出列表中**明确点击
zh-cn**(全小写、短横线;zh_CN、zh-hans、Chinese、zh全无效) - 弹窗提示“是否重启窗口”,必须点
Restart;点Developer: Reload Window不重读locale.json,等于没做
手动编辑 locale.json 是最稳的兜底方式
命令面板卡死、输不了字、点了 zh-cn 仍英文,基本说明 VS Code 没成功写入配置。此时绕过 UI 直接改文件,路径、编码、格式三者都得对。
- 先彻底退出:Windows 查任务管理器杀光所有
Code.exe;macOS 用活动监视器结束Electron和Code Helper;Linux 执行pkill -f "code.*--no-sandbox" - 用文本编辑器打开对应路径下的
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"}(UTF-8 无 BOM,无空格,无逗号,JSON 合法)
验证时只盯住三个核心区域
终端、调试控制台、Git 输出、部分插件弹窗显示英文,属于正常现象——那是它们各自的语言环境,不是 VS Code 汉化失败。
真生效只看这三处:文件/编辑/视图(顶部菜单栏)、请输入命令或搜索设置(命令面板提示)、用户/工作区/扩展(设置左侧导航)。这三处是中文,就是真汉化成功。
右下角状态栏如果还显示 en,说明旧进程还在跑,或者 locale.json 被写到了错误路径——它不在 settings.json 里,也不在安装目录下。


















