VSCode界面中文需同时满足三条件:安装Microsoft官方中文语言包(ID为ms-ceintl.vscode-language-pack-zh-hans)、执行Configure Display Language命令并手动选择zh-cn、彻底重启VS Code;任一缺失均无效。

VSCode界面菜单显示英文,不是系统或字体问题,而是locale配置没生效——必须装对官方语言包、执行Configure Display Language命令选zh-cn、彻底重启三者同时满足,缺一不可。
安装 Microsoft 官方中文语言包(只认 ID)
第三方“汉化插件”名字再像也无效,它们不提供完整翻译资源,还可能污染命令面板或导致Cannot read property 'translate' of undefined报错。
- 按
Ctrl+Shift+X(Windows/Linux)或Cmd+Shift+X(macOS)打开扩展面板 - 搜索完整名称:
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打开命令面板,输入Configure Display Language(注意大小写和空格,不是Change Language或Configure Language) - 从下拉列表中**手动滚动找到并点击
zh-cn** ——ZH-CN、zh_CN、zh-hans、Chinese全部无效 - 弹窗提示“需要重启窗口”时,必须点
Restart;点Cancel或关闭弹窗等于没执行 - VS Code 1.80+ 版本该命令已重命名为
Preferences: Configure Display Language,但搜configure display仍可命中
手动写 locale.json 是最稳的兜底方式
当命令面板打不开、UI 卡死、或批量部署时,直接编辑配置文件绕过所有中间层。它的优先级最高,不依赖插件状态,也不走 UI 流程。
- 彻底退出 VS Code:Windows 查任务管理器杀光所有
Code.exe进程;macOS 在活动监视器结束Code Helper;Linux 执行pkill 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 - 文件内容**仅且只能有一行**:
{"locale":"zh-cn"}(UTF-8 无 BOM,无多余空格、逗号或换行) - 保存后全新启动 VS Code,不是“重新加载窗口”
真正容易被忽略的是:那个 Restart Now 提示只出现一次,关了就得手动进命令面板重调 Configure Display Language;它不保存历史记录,也不自动重试。菜单栏、命令面板占位符、设置左侧导航栏全变成中文才算成功,终端、Git 输出、调试控制台保持英文是正常现象,别误判为失败。


















