必须安装Microsoft官方中文语言包并执行Configure Display Language命令选择zh-cn后重启窗口,手动修改settings.json时locale值须为小写连字符格式,离线安装需用.vsix文件通过Install from VSIX命令。
安装中文语言包必须认准 Microsoft 官方插件
vscode 的中文界面不是靠“汉化补丁”或第三方翻译实现的,而是通过官方发布的语言包扩展。如果装了非 microsoft 发布的“中文插件”,大概率只改菜单栏文字、不翻设置项,甚至导致命令面板乱码或崩溃。
- 打开扩展面板:
Ctrl+Shift+X(Windows/Linux)或Cmd+Shift+X(macOS) - 搜索关键词:
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-CN或Chinese) - VSCode 会提示“需要重启窗口以应用更改”,点
Restart或手动关闭再启动
重启后若右下角状态栏显示 en,可点击它手动切回 zh-cn;这是最直接的验证方式。
settings.json 中的 locale 配置项必须小写连字符
当命令面板失效(比如插件冲突、UI 卡死),或者你想批量部署、脚本化配置时,就得手动编辑配置文件。这里最容易出错的是格式和大小写。
- 打开设置 JSON:
Ctrl+,→ 右上角点击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 Language→zh-cn→Restart
别试图把 .vsix 解压后复制进 extensions 目录——VSCode 1.80+ 已弃用这种手动拷贝方式,会导致插件无法启用或报 Extension is not installed 错误。
真正卡住人的往往不是“找不到插件”,而是装完没切语言、切了没重启、重启了 locale 写错格式、或者用了非官方包。只要每步都盯住 Microsoft、zh-cn、Restart 这三个关键词,基本不会翻车。









