正确安装中文语言包需三步:安装id为ms-ceintl.vscode-language-pack-zh-hans的微软官方插件,执行configure display language命令并选zh-cn,最后必须restart而非reload。

VSCode 没有独立的“中文插件下载包”,所谓下载,本质是安装微软官方语言包 MS-CEINTL.vscode-language-pack-zh-hans,再通过 Configure Display Language 命令激活 —— 其他任何“一键汉化”“离线合集”“第三方汉化补丁”都不可靠,大概率导致命令面板空白、菜单乱码或插件市场失效。
怎么装对中文语言包?只认 ID 和发布者
扩展市场搜 chinese 会出来几十个结果,但真正有效的只有一个:
- 名称必须是
Chinese (Simplified) Language Pack for Visual Studio Code(一字不差) - 发布者必须是
Microsoft(带蓝勾认证) - 扩展 ID 必须是
MS-CEINTL.vscode-language-pack-zh-hans(注意大小写和连字符) - 别点
Chinese Language Pack、VSCode Chinese、Chinese UI这类模糊名称——它们不是微软维护,2026 年起基本签名失效或已下架
装完右下角会弹 Restart Now 提示,必须点它;点 Reload Window 不生效,因为语言资源绑定在进程启动时加载。
为什么装完还是英文?关键在 Configure Display Language
插件只是“字典”,真正切换语言靠的是这条命令。它会自动生成合法的 locale.json 并写入 {"locale":"zh-cn"} —— 手动改 settings.json 已被 VS Code 1.70+ 彻底废弃,无效。
- 按
Ctrl+Shift+P调出命令面板,输入Configure Display Language(注意 C 和 D 大写、中间空格、结尾无标点) - 从下拉列表中严格选择
zh-cn(不是zh、zh_CN、Chinese,输错会导致静默回退) - 弹窗提示“是否重启窗口”,必须点
Restart;后台残留Code.exe或Electron进程会导致新窗口复用旧 locale
验证方式很直接:打开命令面板,看提示文字是不是“请输入命令或搜索设置”;顶部菜单栏是否显示“文件”“编辑”“视图”。终端、Git 输出、调试控制台仍为英文,属于正常现象。
网络打不开市场?离线安装只适用于语言包
如果公司内网或防火墙阻断了 marketplace.visualstudio.com,唯一可行的离线方案是手动下载官方 .vsix 文件:
- 在能联网的机器上,访问 官方语言包页面,点击右上角
Download Extension - 将下载的
vscode-language-pack-zh-hans-*.vsix文件拷贝到目标机器 - 在目标机器 VSCode 中执行
Extensions: Install from VSIX,选中该文件 - 不要双击
.vsix打开 —— 系统默认会调用压缩软件,而非 VSCode 安装器
注意:.vsix 文件必须匹配当前 VSCode 版本(如 v1.95.1),新版 VSCode 会拒绝加载旧签名包;且语言包无依赖,其他插件(如 Python、Copilot)不适用此法。
最常被忽略的不是步骤顺序,而是 locale.json 的生成时机和路径层级 —— 它由 Configure Display Language 命令自动写入用户数据目录,手动创建或放错位置(比如放在工作区目录或 settings.json 里)都无效。只要插件 ID 对、命令输对、选对 zh-cn、彻底重启,三步之内必见中文菜单。











