必须安装Microsoft官方中文语言包、执行Configure Display Language命令选zh-cn、彻底重启三者缺一不可;装错插件、漏重启或locale值错误(如zh_CN)均导致无效。

首次启动 VSCode 后界面仍是英文,不是装错了,而是官方机制要求你主动“启用”中文——必须安装 Microsoft 官方语言包 + 执行 Configure Display Language 命令 + 彻底重启三者缺一不可。
装对语言包:只认 Microsoft 官方 ID MS-CEINTL.vscode-language-pack-zh-hans
VSCode 自带英文,不预装任何中文资源。打开扩展面板(Ctrl+Shift+X),搜 chinese,只装这一项:
- 发布者必须是 Microsoft,名称为
Chinese (Simplified) Language Pack for Visual Studio Code - ID 必须是
MS-CEINTL.vscode-language-pack-zh-hans(注意大小写和连字符) - 所有带“汉化”“一键”“UI 增强”字样的第三方插件都别点——它们不提供完整翻译,还可能让命令面板消失或菜单错位
装完右下角会弹提示“Restart to enable”,但此时界面仍为英文,属正常现象:语言包只是“备好了字典”,还没被调用。
执行 Configure Display Language 命令选 zh-cn
这是唯一生效开关,跳过它,改配置、重载窗口、甚至删重装都没用。操作路径:
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)打开命令面板 - 输入
Configure Display Language(VSCode 1.80+ 版本命令名未变,但需输全称;搜configure display可快速命中) - 回车后从下拉列表中**严格选择
zh-cn**(不是zh_CN、zh、Chinese (Simplified),大小写和连字符必须完全匹配) - 弹出提示后,务必点击 Change and Restart ——
Reload Window不重新初始化语言环境,无效
如果命令面板里压根搜不到这个命令,说明语言包没装成功或没被识别,先卸载重装,再检查扩展是否被禁用(图标变灰需右键启用)。
重启必须杀干净后台进程,否则 locale 不加载
locale.json 或 settings.json 中的 "locale": "zh-cn" 只在全新启动时读取。残留进程会让新窗口继承旧英文环境:
- Windows:任务管理器中结束所有
Code.exe和Code Helper进程 - macOS:活动监视器搜索
Electron,强制退出全部相关进程;或用Cmd+Q退出(不是只关窗口) - Linux:
pkill -f "code"再启动
重启后验证是否真生效:看顶部菜单栏(文件/编辑/视图)、命令面板提示语(“请输入命令或搜索设置”)、设置页左侧导航(用户/工作区/扩展)——这三处全变中文才算成功。
远程开发(Remote-SSH / WSL)要单独配 locale.json
本地设成中文,不影响远程端的 VS Code Server 界面。Remote-SSH 或 WSL 的界面语言由远程机器上的 locale.json 控制:
- 在远程终端中创建文件:
~/.vscode-server/data/Machine/locale.json - 内容仅一行:
{"locale":"zh-cn"}(无空格、无多余逗号、UTF-8 编码) - 保存后断开重连,或运行
code --remote-ssh-verbose触发服务重启
别指望本地设置自动同步过去——VS Code Remote 插件不转发 locale,这是独立进程,必须手动配。
真正卡住人的从来不是“怎么点”,而是 zh-cn 的格式写错、后台进程没杀净、或者误信了非官方插件。右下角状态栏始终显示 en 就是明确信号:没生效,别往下试其他方法,回头重走这三步。











