必须输入完整名称“chinese (simplified) language pack for visual studio code”(括号、空格、大小写全匹配),发布者为microsoft,安装后执行configure display language设locale为"zh-hans"并彻底退出重启。

在 VSCode 扩展市场里搜不到中文包?名字和格式必须严格匹配
搜“中文”“chinese”“汉化”基本找不到官方包,因为 VSCode 市场不支持模糊匹配,只认扩展的完整、精确名称。你必须输入:Chinese (Simplified) Language Pack for Visual Studio Code——一个字母、括号、空格都不能错。
常见失败原因:
- 搜
Chinese(太短)→ 列出几十个第三方插件,很多是过时或带广告的非官方包 - 搜
chinese language pack(大小写/空格不一致)→ 匹配不到 Microsoft 官方发布项 - 搜
zh-hans或zh-CN→ 无结果,这不是插件名,只是语言标识符
认准发布者是 Microsoft,图标是蓝白 VS Code logo + 中文“中”字,下载量超 1000 万次——其他都别点。
安装后界面还是英文?不是没装上,是 locale 配置没生效
语言包只是资源文件,真正控制显示语言的是 locale 设置。装完不重启、不改配置,界面一定还是英文。
必须走这三步:
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入并执行Configure Display Language - 在打开的
locale.json文件中,把值改成"zh-hans"(注意:不是zh-CN,不是zh_cn,小写 + 连字符) - 保存后,**完全退出 VSCode**(Windows 检查任务管理器里是否还有
Code.exe;macOS 看活动监视器里Electron进程是否已结束),再重开
如果改了没反应,大概率是进程没杀干净,或者 settings.json 里有硬编码的 "locale": "en" 覆盖了设置。
命令行安装中文包失败?路径和 PATH 是两个高频雷区
用 code --install-extension 安装离线 .vsix 文件时,报 ENOENT: no such file or directory 几乎全是路径问题。
务必检查:
-
.vsix文件路径不能含中文或空格,比如C:\Users\张三\Desktop\zh.vsix会失败 → 改成C:\vsix\zh.vsix -
code命令没加进系统PATH→ 在 VSCode 里按Ctrl+Shift+P,执行Shell Command: Install 'code' command in PATH - 终端当前目录不是
.vsix所在目录,又没写绝对路径 → 直接用全路径调用:code --install-extension C:\vsix\zh.vsix
离线包必须来自官网直链:https://marketplace.visualstudio.com/_apis/public/gallery/publishers/MS-CEINTL/vsextensions/vscode-language-pack-zh-hans/1.90.0/vspackage,把 1.90.0 替换成你本地 code --version 输出的版本号。
Remote-SSH 连远端服务器后仍是英文?语言包不跨机器生效
本地装好中文包、locale 也设对了,但通过 Remote-SSH 连上去,远端的 VS Code Server 界面还是英文——这不是配置错了,而是设计如此。
VS Code 的语言包只作用于本地客户端 UI,远端 server 是独立二进制,它不读取本地插件,也不共享 locale 设置。
想让远端也中文,唯一办法是确保远端 vscode-server 版本与本地完全一致(如都是 1.90.2),然后在远端也走一遍安装语言包 + Configure Display Language 流程。但更现实的做法是:接受远端英文 UI,专注本地开发体验——毕竟你敲代码、看终端、调试都在本地视图里。











