vscode中文语言包安装后仍显示英文,需手动配置locale.json为{"locale":"zh-cn"}并重启。扩展面板打不开是因网络无法访问marketplace.visualstudio.com,应检查网络或离线安装;搜索“中文”易装错非官方插件,须认准microsoft发布的chinese (simplified) language pack。

VSCode扩展面板打不开或搜索失效
扩展面板(Ctrl+Shift+X)无法加载、搜索框卡死、或输入“Chinese”后无结果,大概率是网络策略拦截了 marketplace.visualstudio.com 请求。这不是插件问题,而是 VS Code 无法连接微软插件市场。
- 先检查是否能访问
https://marketplace.visualstudio.com—— 打开浏览器直接访问,若超时或被重定向,说明网络受限 - 公司内网/教育网常见:可临时切换网络(如手机热点),或改用离线安装方式
- 别反复点击“重新加载”——这只会刷新失败状态;关掉所有 VS Code 进程(Windows 任务管理器查
Code.exe,macOS 活动监视器查Electron或Code Helper),再重试
搜“中文插件”装错第三方包
在扩展面板搜“中文”“汉化”“简体中文”,出来的结果里混着大量非官方插件,图标模糊、描述含广告、更新停滞,装了也不生效,甚至干扰语言切换逻辑。
- 必须严格粘贴全名:
Chinese (Simplified) Language Pack for Visual Studio Code - 发布者必须是
Microsoft,扩展 ID 是ms-ceintl.vscode-language-pack-zh-hans - 认准蓝白 VS Code logo + 中文“中”字图标,其他一律不点
- 装完右下角弹窗提示“Reload Window”只是刷新 UI,不会切换语言——这是新手最常跳过的致命步骤
装完还是英文?关键在 locale.json 配置
语言包只是“翻译词典”,VS Code 默认仍用英文界面。必须显式指定 locale 值为 zh-cn,且格式不能错。
-
Configure Display Language命令搜不到?说明命令未注册,直接编辑配置文件更稳 - 关闭所有 VS Code 窗口 → 找到对应路径:
%APPDATA%\Code\User\locale.json(Win)、$HOME/Library/Application Support/Code/User/locale.json(macOS)、$HOME/.config/Code/User/locale.json(Linux) - 新建或编辑该文件,内容仅一行:
{"locale":"zh-cn"},保存为 UTF-8 无 BOM 编码 - 注意:
zh_CN、zh-hans、ZH-CN全部无效,只接受小写+短横线+双引号包裹
终端、调试控制台仍是英文
VS Code 的终端(Terminal)、调试控制台(Debug Console)、输出面板(Output)等模块使用系统 locale 或 shell 环境变量,不走 VS Code 主语言设置。
- 终端英文是正常现象,不影响代码编写;如需统一,可在系统级设置区域语言(Windows 控制面板 / macOS 系统设置 / Linux
LANG=zh_CN.UTF-8) - 调试控制台显示英文日志(比如 GDB 输出、Python traceback)是底层工具行为,语言包不接管这部分
- 执行
code --install-extension MS-CEINTL.vscode-language-pack-zh-hans命令无实际作用——它只重装语言包,不修复 locale 配置
locale.json,搜不到官方插件就手动下 .vsix 文件——这些绕过 UI 层的操作,才是内网或老旧版本下的真实解法。











