离线安装.vsix语言包必须用code --install-extension命令,双击或拖拽无效;需确保code已加入PATH、路径为绝对路径且无损坏,安装后通过Configure Display Language选zh-cn并彻底重启。

离线安装 .vsix 语言包必须用 code --install-extension
离线环境下,VSCode 不会自动连接扩展市场,所以不能靠 Ctrl+Shift+X 搜索安装。你得手动执行命令行安装,且路径必须指向本地 .vsix 文件。常见错误是直接双击 vsix 文件——这在 VSCode 里根本没反应;或者用图形界面拖入,也不生效。
正确做法是打开终端(Windows 命令提示符 / PowerShell,macOS / Linux 终端),运行:
code --install-extension /path/to/vscode-language-pack-zh-hans-*.vsix
注意:/path/to/... 要替换成你实际下载的文件完整路径,Windows 上路径含空格需加英文双引号包裹;code 命令必须已加入系统 PATH,否则会报“command not found”。没加 PATH 的话,得用 VSCode 安装目录下的完整路径,比如:"C:\Users\XXX\AppData\Local\Programs\Microsoft VS Code\bin\code.cmd"。
Configure Display Language 命令在离线环境仍可用
只要语言包成功安装(可通过 code --list-extensions 查看是否列出 ms-ceintl.vscode-language-pack-zh-hans),命令面板就支持 Configure Display Language。它不依赖网络,只读取已安装的语言包列表。
如果命令搜不到,说明安装失败或包 ID 不匹配——不是名字叫“中文”就行,必须是官方 ID。检查方法:
- 运行
code --list-extensions,确认输出里有ms-ceintl.vscode-language-pack-zh-hans - 没有?重装,别用带空格/特殊字符的路径,也别用浏览器“另存为”可能损坏的 vsix
- 有但命令仍不出现?关掉所有 VSCode 窗口,再开一个干净窗口试试
手动写 locale.json 是离线切换的保底方案
当命令面板卡死、UI 崩溃或批量部署时,直接编辑配置文件最可靠。但要注意三个硬性条件:
- 文件必须放在用户级路径,不是工作区路径:
Windows:%APPDATA%\Code\User\locale.json
macOS:~/Library/Application Support/Code/User/locale.json
Linux:~/.config/Code/User/locale.json - 内容只能是一行严格 JSON:
{"locale":"zh-cn"},不能有注释、不能多空格、不能带 UTF-8 BOM - 保存后必须彻底退出 VSCode 进程:Windows 查任务管理器杀光
Code.exe,macOS 查活动监视器杀Electron,否则新窗口会复用旧进程,语言不变
远程开发(WSL / Remote-SSH)要单独配
离线装完本地中文包,不代表 WSL 或远程服务器上也有。VS Code Remote 启动的是独立的 Server 实例,它读的是远程机器上的配置。
你需要登录到远程环境(如 WSL 终端或 SSH),然后:
- 先确认远程侧
codeCLI 可用(通常code --version能返回) - 把同一份 .vsix 文件传到远程,再运行
code --install-extension xxx.vsix - 在远程侧找到它的
locale.json路径(一般是~/.vscode-server/data/Machine/xxx/locale.json,xxx 是哈希名) - 写入
{"locale":"zh-cn"}并保存 - 在远程窗口中执行
Developer: Reload Window(不是本地窗口)
最容易被忽略的是:远程侧的 locale.json 路径和本地完全不同,且每次 Remote-SSH 连接可能生成新哈希目录,不能想当然复用旧路径。


















