VS Code 中文界面必须安装 Microsoft 官方简体中文语言包并执行 Configure Display Language 命令选择 zh-cn 后重启,第三方插件无效;手动修改 settings.json 需确保是用户级、UTF-8 无 BOM 编码、仅写 "locale": "zh-cn";Remote-SSH/WSL 需单独配置远程端 locale.json。

装错插件是中文不生效的首要原因
VS Code 中文界面必须用 Microsoft 官方语言包,其他名字带“汉化”“中文支持”的第三方插件一律无效。在扩展面板(Ctrl+Shift+X)中搜索 Chinese (Simplified) Language Pack for Visual Studio Code,只认发布者为 Microsoft、ID 是 MS-CEINTL.vscode-language-pack-zh-hans 的那一项。
常见错误现象:
- 命令面板搜不到
Configure Display Language—— 基本就是装错了插件或根本没装成功 - 装完后右下角状态栏仍显示
en,点开也无zh-cn选项 —— 插件未被识别,需卸载重装 - 菜单部分中文、部分英文,或弹窗乱码 —— 第三方插件注入异常脚本,已污染运行时
Configure Display Language 命令才是关键开关
语言包只是“备好了翻译字典”,VS Code 默认仍以英文启动。真正切换靠的是内置命令 Configure Display Language,不是设置里点几下就能改的。
操作路径:
-
Ctrl+Shift+P(Mac 用Cmd+Shift+P)打开命令面板 - 输入
Configure Display Language(注意:不含“中文”二字,别搜change language或chinese) - 回车后选择
zh-cn(必须小写、连字符,不是zh_CN、zh或Chinese) - 弹出提示后点
Restart—— 不是 “Reload Window”,后者不重新加载语言配置
选错后 settings.json 可能被写成 "locale": "zh" 这类无效值,后续再选也无效,得手动清理。
settings.json 手动加 locale 失效?检查这三点
当命令面板打不开、或执行了命令但重启后仍是英文,直接改配置文件最稳,但有三个硬性条件:
- 打开的是用户级
settings.json(用Ctrl+Shift+P→Open User Settings (JSON),别去改工作区或默认设置) - 文件编码必须是 UTF-8 无 BOM,否则中文乱码或整行配置被忽略
- 只加一行:
"locale": "zh-cn",已有该字段就只改值,不要重复写 key
macOS 路径:$HOME/Library/Application Support/Code/User/settings.json
Linux 路径:$HOME/.config/Code/User/settings.json
Remote-SSH / WSL 下仍是英文?那是远程实例没配
本地设成中文不代表远程环境也生效。Remote-SSH 或 WSL 中 VS Code Server 的语言配置是独立的,需单独处理。
操作路径:
- 连接到远程机器后,在远程 VS Code 中执行
Configure Display Language并选zh-cn,然后Restart - 若命令不可用,直接在远程机器上编辑:
~/.vscode-server/data/Machine/<uuid>/locale.json</uuid> - 确保该文件内容为:
{"locale":"zh-cn"},且文件权限可读
右下角状态栏显示 en 却无法切换?点击它,从下拉菜单直接选 zh-cn 是最快兜底方式。终端、调试控制台、Git 提示、部分插件弹窗天然不走主界面语言配置,显示英文属正常,别误判为失败。


















