必须安装Microsoft官方中文语言包、设locale为"zh-cn"并彻底重启三者缺一不可;搜“中文插件”易装错,应严格输入全名Chinese (Simplified) Language Pack for Visual Studio Code,认准发布者Microsoft,安装后执行Configure Display Language命令或手动编辑locale.json文件并杀掉后台进程再重启。

怎么装对中文语言包
VSCode 没有内置中文界面,必须装官方 Chinese (Simplified) Language Pack for Visual Studio Code 才能真正汉化。搜“中文插件”“汉化包”“vscode 中文”大概率会点进非官方扩展,装了也不生效。
正确做法只有三步:
- 按
Ctrl+Shift+X打开扩展面板 - 搜索框里**逐字输入**:
Chinese (Simplified) Language Pack for Visual Studio Code(括号、空格、大小写都得一致) - 认准发布者是
Microsoft,图标是蓝白 VS 标志,点 Install
装完右下角会弹提示:“Language changed to Chinese (Simplified). Reload window to apply?”——点 Reload,不是关掉再打开,是直接重载窗口。
装完还是英文?检查 locale.json 和命令面板
reload 后仍是英文,90% 是配置没落到位,和网络、插件本身无关。
优先用命令面板验证并修复:
- 按
Ctrl+Shift+P,输入Configure Display Language - 选中
zh-cn(注意:必须小写,用短横线,不是zh_CN、zh-CN或zh) - 点“是”重启窗口
如果命令面板打不开或无效,就手动编辑 locale.json:
- Windows 路径:
%APPDATA%\Code\User\locale.json - macOS 路径:
$HOME/Library/Application Support/Code/User/locale.json - Linux 路径:
$HOME/.config/Code/User/locale.json - 文件内容只写一行:
{"locale":"zh-cn"},保存为 UTF-8 无 BOM
离线环境怎么装中文包
内网、断网、强防火墙环境下,不能靠扩展市场在线安装,但语言包本身是静态 .vsix 文件,完全支持离线部署。
关键不是随便下个 .vsix,而是确保来源可靠、版本匹配:
- 从微软官方 GitHub 发布页下载:
vscode-language-pack-zh-hans(注意不是vscode-language-pack-zh-hans.vsix这种带后缀的文件名,GitHub 上是 release 包) - 或者用官方 API 拼 URL 下载:
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/ms-ceintl/vsextensions/vscode-language-pack-zh-hans/1.92.0/vspackage(publisher 是ms-ceintl,extension_name 是vscode-language-pack-zh-hans,version 查 release 页) - 别用第三方镜像站或百度网盘分享的 .vsix,很多已过期或被篡改
下载后,在 VSCode 命令面板执行 Extensions: Install from VSIX...,选中文件即可。装完仍需执行 Configure Display Language 或写 locale.json。
为什么改了 locale 还是英文
VSCode 的界面语言跟系统语言完全无关——Windows 设置成中文,VSCode 默认还是英文;Mac 系统语言是英文,只要配对了 locale.json,照样显示中文。
真正卡住的往往是这些细节:
-
locale.json文件路径错了,比如写到了工作区目录下,而不是用户数据目录 - 文件编码不对,用了 UTF-8 with BOM 或 GBK,VSCode 读取失败后静默忽略
- VSCode 后台进程没杀干净,尤其是 Windows 上残留
Code.exe或Code Helper,导致新配置不加载 - 企业版或 Snap 安装的 VSCode 会绕过用户配置,此时必须启动时加参数:
code --locale=zh-cn
最稳的验证方式:关掉所有 VSCode 窗口 → 任务管理器/活动监视器清空残留进程 → 再启动,看是否立即中文。否则就是配置没生效,不是插件问题。


















