vscode切换中文界面需安装官方中文语言包并配置locale为zh-cn。windows/macos/linux均适用,但需注意字体、权限、重启方式及配置文件路径差异,错误配置会导致汉化失败。

VSCode 切换中文界面,核心就两步:装对包、设对 locale 值,缺一不可。Windows/macOS/Linux 都一样,但细节稍有差异,尤其 locale 写法和重启方式容易出错。
必须安装 Microsoft 官方中文语言包
不是随便搜“chinese”点安装就行——很多第三方包名字相似但不维护,会导致界面部分汉化或后续更新失效。打开扩展面板(Ctrl+Shift+X),搜索 Chinese (Simplified) Language Pack for Visual Studio Code,确认发布者是 Microsoft,下载量超千万次再安装。
- Linux 用户注意:若系统缺少中文字体(如文泉驿、Noto Sans CJK),装完语言包后菜单可能显示方块,需额外安装字体包
- macOS 用户首次安装后,可能需在「系统设置 → 隐私与安全性 → 辅助功能」里手动勾选 VS Code,否则某些 UI 元素(如弹窗按钮)仍为英文
- 装完不重启?VSCode 通常会弹窗提示,但若没弹,别等,直接下一步手动配置
Configure Display Language 命令必须选 zh-cn(小写+连字符)
这是跨平台最常翻车的点。按 Ctrl+Shift+P(macOS 用 Cmd+Shift+P)调出命令面板,输入 Configure Display Language 并回车。弹出列表后——
- 不要靠键盘上下键快速跳转,容易误选
zh-CN或Chinese (Simplified);必须手动滚动到底部,找到明确写着zh-cn的那一项 -
zh-cn是唯一被 VSCode 运行时识别的 locale 值;zh_CN、zh-CN、zh全部无效,选了也白选 - 选中后弹窗提示“Restart”,此时要彻底退出 VSCode:Windows 任务管理器杀掉所有
Code.exe进程;macOS 活动监视器结束Code和Code Helper;Linux 用pkill -f code
手动修改 locale.json 作为备用方案
如果命令面板方式失效(比如列表里根本没 zh-cn),说明语言包没正确加载,可直接改配置文件。路径如下:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
用任意文本编辑器打开该文件,确保内容为:
{"locale":"zh-cn"}
保存后彻底退出 VSCode 再启动。若文件不存在,就新建一个;若存在但内容是 {"locale":"en"} 或空对象,直接覆盖即可。
重启后仍是英文?先查这三件事
不是重装就能解决,得定位具体卡在哪一环:
- 检查设置里是否误开了
workbench.startupEditor等实验性功能,某些旧版插件会干扰语言加载顺序 - 打开设置(
Ctrl+,),搜索locale,看右侧值是不是真的显示为zh-cn;如果显示为空或en,说明配置没生效 - 终端里运行
code --status,观察输出中locale字段是否为zh-cn;不是的话,说明 VSCode 启动时读取的是系统级 locale,而非用户配置
真正麻烦的不是装不上,而是装上了但被其他插件或系统环境变量悄悄覆盖——尤其是团队共用配置或远程开发场景下,locale.json 可能被 .vscode/settings.json 里的 workspace 设置顶掉。











