VSCode如何设置中文语言_界面汉化与语言包安装指南

10次阅读

必须安装microsoft官方中文语言包并执行Configure display Language命令选择zh-cn后重启窗口,手动修改settings.json时locale值须为小写连字符格式,离线安装需用.vsix文件通过Install from VSIX命令。

安装中文语言包必须认准 Microsoft 官方插件

vscode 的中文界面不是靠“汉化补丁”或第三方翻译实现的,而是通过官方发布的语言包扩展。如果装了非 microsoft 发布的“中文插件”,大概率只改菜单栏文字、不翻设置项,甚至导致命令面板乱码或崩溃。

  • 打开扩展面板:Ctrl+Shift+Xwindows/linux)或 Cmd+Shift+XmacOS)
  • 搜索关键词:Chinese (Simplified) Language Pack for visual studio Code
  • 确认发布者是 Microsoft,不是“Chinese Language Pack”“vscode Chinese”等模糊名称
  • 点击 Install,等待状态变为 Installed

注意:安装完不会自动切换语言,这只是“备好弹药”,还没扣扳机。

切换显示语言必须用 Configure Display Language 命令

很多人装完就关 VSCode 重启,结果发现还是英文——因为 VSCode 默认仍使用系统语言或上一次配置,语言包本身不主动激活。

  • Ctrl+Shift+P 打开命令面板
  • 输入并选择:Configure Display Language
  • 在弹出列表中选 zh-cn(不是 zh-CNChinese
  • VSCode 会提示“需要重启窗口以应用更改”,点 Restart 或手动关闭再启动

重启后若右下角状态栏显示 en,可点击它手动切回 zh-cn;这是最直接的验证方式。

settings.json 中的 locale 配置项必须小写连字符

当命令面板失效(比如插件冲突、ui 卡死),或者你想批量部署、脚本化配置时,就得手动编辑配置文件。这里最容易出错的是格式和大小写。

  • 打开设置 jsonCtrl+, → 右上角点击 Open Settings (JSON) 图标
  • 添加或修改这一行:"locale": "zh-cn"
  • 不能写成 "locale": "zh_CN""locale": "zhCN""LOCALE": "zh-cn"
  • 保存后执行 Developer: Reload Window(不用全重启,但部分旧版本仍需重启)

如果改完没反应,检查是否多写了逗号、引号不匹配,或被其他插件的配置覆盖(比如某些主题插件会偷偷重写 locale)。

离线环境安装需用 .vsix 文件 + Install from VSIX

公司内网、教育网或防火墙严格限制时,扩展市场打不开,但语言包本身是纯静态资源,完全支持离线部署。

  • 在能联网的机器上访问:https://marketplace.visualstudio.com/items?itemName=MS-CEINTL.vscode-language-pack-zh-hans
  • 点击 Download Extension,得到一个 vscode-language-pack-zh-hans-*.vsix 文件
  • 在目标机器的 VSCode 中按 Ctrl+Shift+P,输入并运行:Extensions: Install from VSIX...
  • 选中下载好的 .vsix 文件,安装后仍需执行 Configure Display Languagezh-cnRestart

别试图把 .vsix 解压后复制进 extensions 目录——VSCode 1.80+ 已弃用这种手动拷贝方式,会导致插件无法启用或报 Extension is not installed 错误。

真正卡住人的往往不是“找不到插件”,而是装完没切语言、切了没重启、重启了 locale 写错格式、或者用了非官方包。只要每步都盯住 Microsoftzh-cnRestart 这三个关键词,基本不会翻车。

text=ZqhQzanResources