vs code 中文界面需同时满足安装微软官方中文语言包、执行 configure display language 命令设 locale 为 "zh-cn"、彻底重启进程三条件;认准扩展 id ms-ceintl.vscode-language-pack-zh-hans,仅 zh-cn 有效,第三方插件易导致乱码或失效。

VSCode 不会因为装了中文包就自动变中文,必须同时满足三个条件:安装 Microsoft 官方语言包、把 locale 设为 "zh-cn"、彻底关闭所有进程后重启——缺一不可。
认准官方扩展 ID:ms-ceintl.vscode-language-pack-zh-hans
搜“中文插件”“汉化包”大概率装错。第三方扩展可能乱码、带广告,甚至劫持主页。正确做法是:
- 按
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,图标带蓝白 VS 标志和“中”字 - 点击
Install,安装完别点右上角的 “Reload” —— 它不触发语言切换
必须用 Configure Display Language 命令设 locale 为 zh-cn
语言包只是翻译资源,“用哪本字典”由 locale 字段决定。这个值不能靠设置界面下拉菜单选(那个选项已失效),也不能随便往 settings.json 里加。
- 按
Ctrl+Shift+P打开命令面板,输入并选择Configure Display Language - 它会打开
locale.json文件,把内容改成:{"locale":"zh-cn"} - 注意:必须小写、短横线、双引号包裹;
zh_CN、zh-hans、Chinese全无效 - 保存后,必须点弹窗里的
Restart按钮,或手动杀掉所有后台进程再重开
手动改 locale.json 时路径和编码不能错
如果命令面板打不开,或想批量部署,直接编辑配置文件更稳。但路径和编码错了就白改:
- Windows 路径:
%APPDATA%\Code\User\locale.json - macOS 路径:
$HOME/Library/Application Support/Code/User/locale.json - Linux 路径:
$HOME/.config/Code/User/locale.json - 用 VS Code 自己打开该文件,只写一行:
{"locale":"zh-cn"} - 保存时确保是 UTF-8 无 BOM 编码;文件名必须是
locale.json,不是settings.json或其他
重启没生效?先杀干净后台进程
这是最常被忽略的环节。VSCode 新窗口若复用旧进程,locale 配置根本不会加载:
- Windows:任务管理器中结束所有
Code.exe和Code Helper进程 - macOS:活动监视器中搜索
Electron,强制退出全部相关项 - Linux:终端运行
pkill -f "code"再启动 - 验证是否真生效:看菜单栏、设置页、命令面板是否都变成中文,而不仅是右下角状态栏
真正卡住的地方往往不是操作步骤,而是后台进程没清干净,或者 locale 值写成了 zh-hans 或 zh_CN——这两个在部分版本里会导致设置页、调试面板仍为英文,必须用 zh-cn。











