vs code中文界面需装对官方插件并显式启用语言:安装microsoft发布的ms-ceintl.vscode-language-pack-zh-hans插件,执行configure display language命令选zh-cn(小写连字符),彻底重启所有进程。

VSCode 安装中文界面不是“装完插件就自动变中文”,关键在两步:装对插件 + 显式启用语言。装错插件、漏掉 Configure Display Language 命令、或 locale 写成 zh-CN(大写或下划线)都会导致界面仍是英文。
怎么确认装的是官方中文语言包?
搜索时必须输入全名 Chinese (Simplified) Language Pack for Visual Studio Code,只搜 chinese 极易装错。认准发布者是 Microsoft,ID 是 ms-ceintl.vscode-language-pack-zh-hans。别点 Chinese Language Pack 或 VSCode Chinese 这类非官方扩展——它们不更新、不兼容新版本,甚至可能注入广告。
- 安装后右下角弹窗提示“需要重启”只是提醒你插件已就绪,不代表语言已切换
- 插件本身只是“字典”,真正调用它的是 VSCode 的 locale 配置
- 如果扩展面板里显示“已安装”但界面没变,说明还没执行语言切换命令
为什么执行 Configure Display Language 后还是英文?
最常见原因是选了错误的 locale 值:zh-cn 必须全小写、用连字符(-),zh_CN、zh-CN、ZH-CN 全部无效。这个值区分大小写且格式严格,VSCode 不会自动纠错。
- 按
Ctrl+Shift+P→ 输入Configure Display Language→ 从下拉列表里选zh-cn(不是手动输入) - 选完后弹出“是否重启窗口”,必须点 是,不能忽略
- 重启前关掉所有 VSCode 窗口,并在任务管理器里结束残留的
Code.exe或Code Helper进程,否则旧 locale 缓存仍在
离线环境或命令面板失效时怎么办?
直接编辑 locale.json 是最稳定的方式,绕过 UI 层,适用于内网、教育网或插件市场打不开的场景。
- 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 编码 - 改完立刻退出所有 VSCode 进程再重开,无需重启电脑
装完中文插件后界面仍部分英文?
这是正常现象,不是插件问题。VSCode 的 locale 仅控制 UI 文本(菜单、设置项、提示框等),不影响以下内容:
- 终端输出(
node -v、npm install等命令结果仍是英文) - 第三方插件自己的界面(比如
Vim插件的模式提示、C/C++插件的诊断信息) - 调试器变量名、堆栈跟踪里的系统路径和函数名
- 悬停提示中的英文术语(如
Promise、async)——这是语言规范本身,不是翻译缺失
真正容易被忽略的是:locale 设置只作用于当前用户配置,如果你用管理员权限运行 VSCode,或在多用户系统中切换账户,得分别配置每个用户的 locale.json。











