离线安装 vscode 中文包必须通过 extensions: install from vsix 安装官方 ms-ceintl.vscode-language-pack-zh-hans 包,再执行 configure display language 选 zh-cn 并彻底重启,否则界面不生效。

离线安装 VSCode 中文包,不是复制文件就能用——必须走 Extensions: Install from VSIX 命令注册扩展 ID,再手动设 locale 为 "zh-cn" 并彻底重启,否则界面永远是英文。
下载正确的官方 .vsix 文件
只认发布者为 MS-CEINTL、ID 为 ms-ceintl.vscode-language-pack-zh-hans 的包。名字带“汉化”“中文支持”的第三方插件一律跳过。
- 从官网直接下载:VS Code 中文语言包页面 → 拉到底部点 Download Extension
- 文件名应类似
MS-CEINTL.vscode-language-pack-zh-hans-1.103.2025080609.vsix(版本号需匹配你本地code --version输出的主版本,如1.103.x) - 右键解压 .vsix(本质是 zip),打开
package.json,确认"engines": {"vscode": "^1.103.0"}与你环境一致 - ARM Mac 用户务必检查文件名是否含
darwin-arm64;x64 机器装错架构会静默失败
用命令面板安装 .vsix,别双击
VSCode 自 1.70 起已禁用双击或拖拽 .vsix 的方式——它只会把文件拷进 ~/.vscode/extensions/ 目录,但不注册、不激活、不加载资源,后台无提示、前端无反应。
- 在目标机器上启动 VSCode(确保是你要部署的版本)
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)调出命令面板 - 输入并选择
Extensions: Install from VSIX,回车 - 在弹窗中定位到你存放 .vsix 的路径(建议纯英文路径,如
C:\vsix\或~/Downloads/),选中后点Install - 安装完成后,打开扩展面板(
Ctrl+Shift+X),搜索ms-ceintl.vscode-language-pack-zh-hans,确认状态为 已启用
必须执行 Configure Display Language 并选 zh-cn
装完不等于生效。Configure Display Language 是唯一能写入正确 locale.json 并触发 UI 语言协商的动作。填错值、漏重启、点错按钮,全白干。
- 再次按
Ctrl+Shift+P,输入完整命令名:Configure Display Language(注意大小写和空格) - 在下拉列表中**严格选择
zh-cn** ——zh-hans在 1.95+ 版本中仅加载部分 UI;zh_CN、Chinese、zh全部无效 - 弹出提示后,务必点 Restart(不是 Reload Window)
- 若命令面板搜不到该命令,说明语言包根本没注册成功,需先卸载再重走上一步
验证是否真生效,只盯三处
终端、Git 提示、调试控制台天生不走 locale 配置,显示英文≠失败。真正决定成败的是这三块:
- 顶部菜单栏(文件、编辑、视图…)
- 命令面板(
Ctrl+Shift+P弹出的提示文字) - 设置导航栏(左侧 设置、扩展、管理 标签)
任一区域仍为英文,说明 locale.json 没被读取或值错误。此时检查:~/.config/Code/User/locale.json(Linux)、%APPDATA%\Code\User\locale.json(Windows)、$HOME/Library/Application Support/Code/User/locale.json(macOS)是否存在且内容为 {"locale":"zh-cn"},编码为 UTF-8 无 BOM。后台进程残留也常导致配置不加载——Windows 杀光所有 Code.exe,macOS/Linux 执行 pkill -f "Electron" 再重开。











