离线安装中文语言包必须用code --install-extension命令,双击.vsix文件无效;安装后需执行Configure Display Language选zh-cn并彻底重启,或手动编辑locale.json为{"locale":"zh-cn"}(UTF-8无BOM)并杀净进程后启动。

离线安装中文语言包必须用 code --install-extension
离线安装不是把 .vsix 文件双击打开,VS Code 不识别这种操作。必须通过命令行调用内置安装器,否则扩展根本进不到插件列表里,后续所有步骤都无效。
操作要点:
- 先确认 VS Code 已安装且
code命令在系统 PATH 中(Windows 可用 PowerShell,macOS/Linux 用终端) - 下载的文件名必须是官方发布的完整包名,例如
vscode-language-pack-zh-hans-1.93.0.vsix,不能重命名或解压 - 执行命令:
code --install-extension vscode-language-pack-zh-hans-1.93.0.vsix - 成功后终端会输出
Extension 'vscode-language-pack-zh-hans' was successfully installed.
Configure Display Language 命令搜不到?说明语言包没装进运行时
这个命令本质是读取已启用的扩展列表并生成 locale.json。如果它在命令面板(Ctrl+Shift+P)里搜不到,基本等于语言包没被 VS Code 识别——不是下载错了,就是安装路径不对,或者扩展被禁用了。
验证方式:
- 执行
Extensions: Show Installed Extensions,检查ms-ceintl.vscode-language-pack-zh-hans是否出现在列表中且状态为 Enabled - 如果显示 Disabled,手动点击启用;如果根本没出现,说明
--install-extension没生效,需重试或换路径再装 - 注意:某些企业策略会禁止命令行安装扩展,此时需联系 IT 管理员放开策略
手动写 locale.json 是最稳的兜底方案
命令面板打不开、UI 卡死、或批量部署时,直接改配置文件反而最快。但必须满足三个硬性条件,缺一不可:
- 文件路径必须准确:
Windows:%APPDATA%\Code\User\locale.json
macOS:$HOME/Library/Application Support/Code/User/locale.json
Linux:$HOME/.config/Code/User/locale.json - 内容只能是严格 JSON 格式:
{"locale":"zh-cn"},不能多空格、不能加注释、不能有 BOM 头 - 文件编码必须是 UTF-8 无 BOM,用记事本保存会悄悄加 BOM,推荐用 VS Code 自己新建文件再保存
改完不重启 = 白改。务必关闭所有 Code.exe(Windows)、Electron(macOS)或 code(Linux)进程后再启动。
远程开发(SSH/WSL)中文不生效?本地设置不管用
VS Code 的 locale.json 是用户级配置,只作用于当前运行实例。Remote-SSH 或 WSL 启动的是独立的远程服务进程,它读的是远程机器上的 locale.json,和你本地的完全无关。
解决方法只有两个:
- 在远程机器上重复上述离线安装 + 手动写
locale.json流程(注意路径是远程系统的路径) - 或通过 Remote Explorer 连接后,在远程窗口里按
Ctrl+Shift+P执行Configure Display Language,确保选的是远程端已安装的语言包
最容易被忽略的一点:远程环境可能没有图形界面依赖,导致语言资源加载失败。此时要确认远程系统已安装基础中文字体(如 fonts-wqy-zenhei),否则菜单能变中文,但弹窗、提示框仍可能乱码或空白。


















