离线安装vscode中文包唯一有效路径是:ctrl+shift+p→extensions: install from vsix→选vscode-language-pack-zh-hans-*.vsix→再执行configure display language选zh-cn→点restart;双击或拖拽.vsix无效,因vscode 1.70+已禁用直载机制,仅复制文件却不注册扩展、不加载资源。

离线安装中文包,唯一能走通的路径是:Ctrl+Shift+P → 输入 Extensions: Install from VSIX → 选中正确版本的 vscode-language-pack-zh-hans-*.vsix → 安装后必须再执行 Configure Display Language 并手动选 zh-cn → 点 Restart(不是 Reload Window)。
为什么双击.vsix或拖拽进窗口无效
VSCode 自 1.70 版起已禁用文件系统直载机制。双击或拖入只会把文件复制到扩展目录(如 %USERPROFILE%\.vscode\extensions\),但不会注册扩展 ID、不触发语言资源加载流程、也不写入启用状态。现象是右下角仍显示 en,设置页、命令面板、调试视图全英文,且无任何错误提示。
- 验证是否真安装成功:打开扩展面板,搜索
ms-ceintl.vscode-language-pack-zh-hans,看是否显示“已启用” - 若没启用,说明只是存了文件,没走安装器流程——必须先
Uninstall,再重走命令面板安装 - 别信“改后缀为 zip → 改
engines.vscode→ 再打包”的操作,VSCode 1.95+ 会校验签名和结构,大概率报Extension is not compatible或直接拒绝解压
怎么选对版本的 .vsix 文件
语言包版本必须与本地 VSCode 主版本号严格匹配,小版本号可略高(如 VSCode 1.92.x 可用 vscode-language-pack-zh-hans-1.93.*.vsix),但主版本号错一位(如 1.92 vs 1.94)就会静默失败或报错。
- 查当前 VSCode 版本:菜单栏 Help → About,看第一行 “Version X.YY.ZZ…”
- 下载渠道优先选微软官方 GitHub 发布页:
https://github.com/microsoft/vscode-loc/releases,找带vscode-language-pack-zh-hans的资产文件 - 避免用 Marketplace 页面拼接 URL 下载——部分镜像或旧链接返回的是
Microsoft.VisualStudio.Services.VSIXPackage,需手动重命名,且易因 CDN 缓存导致版本错乱 - 发布者 ID 必须是
ms-ceintl,其他 ID(如 community fork)可能缺失关键翻译或无法通过 locale 匹配
装完还是英文?重点检查这三处
安装 + 选 zh-cn 后仍不生效,90% 是环境残留或配置路径错误,不是包本身问题。
- 后台进程未彻底退出:Windows 杀光所有
Code.exe;macOS/Linux 执行pkill -f "Code Helper"和pkill -f "Electron",再启动 -
locale.json路径和内容必须精准:
— Windows:%APPDATA%\Code\User\locale.json
— Linux:~/.config/Code/User/locale.json
— macOS:$HOME/Library/Application Support/Code/User/locale.json
— 内容仅一行:{"locale":"zh-cn"}(UTF-8 无 BOM,小写,短横线,双引号) - 远程开发(SSH/WSL)需单独部署:本地装了对远程窗口完全无效。必须在远程机器上重复
Install from VSIX+Configure Display Language+ Restart Remote Window
最常被跳过的动作是重启方式——点 Reload Window 不会重载语言包,只有 Restart(命令面板里选完 zh-cn 后弹出的按钮)才会清空语言缓存并重新协商 UI 语言。这个细节在 VSCode 1.90+ 中变得更关键,因为语言加载逻辑已从启动阶段前移到 session 初始化环节。











