必须使用MS-CEINTL.vscode-language-pack-zh-hans官方.vsix包,下载后解压检查package.json中vscode版本匹配,安装后需通过Configure Display Language设为zh-cn并彻底重启。

离线安装中文语言包必须用 MS-CEINTL.vscode-language-pack-zh-hans,其他名字的“汉化插件”基本无效,装了也切不出中文界面。
怎么确认下载的是官方正版 .vsix
VS Code 官方简体中文包只有一个发布者:MS-CEINTL。所有非此 ID 的插件(比如叫 “Chinese Language Pack” 但发布者是 “xyz123”)都是仿冒或旧版,不兼容当前 VS Code。
- 正确路径:打开 官网页面 → 拉到底部 → 点 Download Extension → 下载文件名形如
MS-CEINTL.vscode-language-pack-zh-hans-1.90.2.vsix - 别信百度搜出的网盘链接、压缩包、exe 封装器——那些大概率含广告或已过期
- 下载后右键 → 解压(.vsix 本质是 zip),打开
package.json,确认"engines": {"vscode": "^1.90.0"}中版本号与你本地code --version输出的第一段匹配(如 1.90.2 → 取 1.90)
安装完还是英文?重点查这三处
装完不生效,90% 是因为启动方式、系统 locale 或配置项冲突,不是插件没装上。
- 别双击旧快捷方式:它可能指向已卸载的老版本 VS Code 目录;改从「开始菜单」或「应用坞」里重新打开
- Windows 上若系统区域设为 English (United States) 且勾了「Beta: Use Unicode UTF-8…」,会跳过语言包;macOS/Linux 检查终端输出
echo $LANG,如果是en_US.UTF-8就得手动干预 - 打开
settings.json,删掉任何硬编码的"locale": "en"或"locale": "zh-CN"—— 正确写法只认小写连字符格式:"locale": "zh-cn",多一个大写或下划线都失效
命令行安装失败常见报错及解法
code --install-extension 对路径极其敏感,报错往往和网络无关。
-
ENOENT: no such file or directory:路径含中文、空格或特殊符号(如C:\Users\张三\Desktop\zh.vsix);解决:把 .vsix 移到纯英文路径,例如C:\vsix\zh.vsix,再执行命令 -
command not found: code:终端找不到code命令;解决:在 VS Code 里按Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车运行 -
Extension is not compatible:不是版本错,是架构错——ARM Mac 装了 x64 版本的 .vsix;检查文件名是否含darwin-arm64,没有就去官网重下对应架构版本
内网批量部署时最容易漏掉的关键点
只拷 .vsix 文件过去,等于只送了“安装包”,没送“弹药”。很多语言类插件(包括中文包本身)首次启用会动态加载资源,离线环境必须提前触发完整初始化。
- 在有网机器上:安装 .vsix → 打开任意一个 .txt 文件 → 按
Ctrl+Shift+P输入Configure Display Language→ 选zh-cn→ 等右下角状态栏变成中文 → 再重启一次窗口 - 然后拷整个扩展目录过去:
~/.vscode/extensions/MS-CEINTL.vscode-language-pack-zh-hans-1.90.2/(Linux/macOS)或%USERPROFILE%\.vscode\extensions\MS-CEINTL.vscode-language-pack-zh-hans-1.90.2\(Windows) - 别只拷
.vsix,否则某些字体渲染、翻译缓存、UI 本地化资源缺失,界面仍部分英文


















