VSCode中文界面必须安装Microsoft官方语言包、执行Configure Display Language命令并彻底重启,三者缺一不可;装错插件、跳过命令或仅“重新加载窗口”均无效。

VSCode 中文界面不是在设置菜单里点几下就能开的,必须装对插件 + 执行指定命令 + 彻底重启,三者缺一不可;跳过任一环节,哪怕 settings.json 里写了 "locale": "zh-cn",界面照样是英文。
安装 Microsoft 官方中文语言包
VSCode 本身不带中文资源,所有“汉化”都依赖官方语言包。只认这一项:Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是 Microsoft,ID 是 MS-CEINTL.vscode-language-pack-zh-hans。
- 按
Ctrl+Shift+X(Windows/Linux)或Cmd+Shift+X(macOS)打开扩展面板,搜chinese,只点那个带蓝勾认证的 - 别装名字含“汉化”“一键切换”“中文增强”的第三方插件——它们不提供完整翻译,还可能污染命令面板,导致后续
Configure Display Language命令根本不出现在命令面板里 - 安装完别点右上角 Reload 按钮,它不生效;右下角若弹出提示,必须点
Change and Restart - 如果没弹窗,检查任务管理器或活动监视器里是否还有残留的
Code.exe或Code Helper进程,杀干净再重开
执行 Configure Display Language 命令
语言包只是“备好了字典”,真正让 VSCode 切换语言的是这个命令。它会写入 "locale": "zh-cn" 到用户配置中,并触发完整重载。
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)打开命令面板 - 输入
Configure Display Language(注意:不是 “Change Language”“Set Chinese” 或 “中文” 等词) - 回车后,在弹出列表中**只选
zh-cn** ——ZH-CN、zh_CN、zh、Chinese全部无效,且无报错,界面静默维持英文 - 弹窗提示后必须点
Restart(不是Reload Window),否则配置不加载 - 如果误选了
zh,settings.json会被写成无效值,需手动删掉"locale"行再重试
手动改 settings.json 是最稳的兜底方式
当命令面板打不开、卡死,或执行后仍无效时,直接编辑配置文件绕过 UI 层,成功率最高,但有三个硬性条件必须满足。
- 用
Ctrl+Shift+P→Open User Settings (JSON)打开的是用户级settings.json,不是工作区或默认设置 - 文件编码必须是 UTF-8 无 BOM,否则整行被忽略或中文乱码
- 只加一行:
"locale": "zh-cn";已有该字段就只改值,不要重复 key - Windows 路径:
%APPDATA%\Code\User\settings.json;macOS:~/Library/Application Support/Code/User/settings.json;Linux:~/.config/Code/User/settings.json - 改完保存,彻底退出 VSCode(包括托盘进程),再重新启动
Remote-SSH / WSL 下中文不生效?那是远程端没配
本地设成中文,不影响 Remote-SSH 或 WSL 里的 VS Code Server 界面。远程端是独立进程,有自己的 locale 配置,必须单独处理。
- 在远程终端中,创建路径:
~/.vscode-server/data/Machine/locale.json - 内容仅一行:
{"locale":"zh-cn"} - 保存后断开重连,或运行
code --remote-ssh-verbose触发服务重启 - 注意:远程端还要确保系统已安装中文字体(如
fonts-wqy-zenhei),且LANG=zh_CN.UTF-8已设在~/.profile或/etc/default/locale中 - 终端输出、调试器日志、Jupyter 内核提示等,都不受 VSCode 主程序 locale 控制,它们取决于各自进程的语言环境
最容易被忽略的一点:VSCode 1.80+ 版本已将命令重命名为 Preferences: Configure Display Language,旧教程里搜不到原名是正常的;而远程开发场景下,本地和远程的 locale 配置完全隔离,混为一谈只会反复踩坑。











