离线安装VSCode中文包必须通过Extensions: Install from VSIX命令安装、手动执行Configure Display Language选zh-cn、彻底重启三步闭环;双击或拖拽.vsix无效,因VSCode自1.70起禁用该机制,仅复制文件而不注册扩展ID、不触发资源加载。

离线安装 VSCode 中文包,必须走 Extensions: Install from VSIX 命令 + Configure Display Language 手动选 zh-cn + 彻底重启三步闭环,双击 .vsix、拖拽进窗口、code --install-extension 命令行全部无效。
为什么双击 .vsix 文件不生效
VSCode 自 1.70 版起已禁用文件系统直接加载机制。双击或拖入只是把 vscode-language-pack-zh-hans-*.vsix 复制到 ~/.vscode/extensions/(Linux/macOS)或 %USERPROFILE%\.vscode\extensions\(Windows),但不会注册扩展 ID、不触发语言资源加载流程,也不会写入激活状态。
- 现象:右下角仍显示
en,设置页、命令面板、调试视图全英文,且无任何错误提示 - 验证方式:打开扩展面板搜索
ms-ceintl.vscode-language-pack-zh-hans,若未显示“已启用”,说明根本没装进去 - 补救操作:先点击扩展右上角
… → Uninstall,再重新走命令面板安装
Install from VSIX 怎么正确执行
这是离线安装唯一被官方支持的路径,所有步骤必须在 VSCode 图形界面内完成,不能跳过交互环节。
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)呼出命令面板 - 输入
Extensions: Install from VSIX,回车确认 - 在弹出的原生文件选择框中,定位并选中提前下载好的
vscode-language-pack-zh-hans-*.vsix(发布者必须为MS-CEINTL,ID 必须是ms-ceintl.vscode-language-pack-zh-hans) - 点击
Install,等待提示“Installation completed”
Configure Display Language 必须手动选 zh-cn
装完 .vsix ≠ 界面变中文。VSCode 不会自动切换语言,必须显式调用语言协商逻辑,而它只认 zh-cn 这个值。
- 再次按
Ctrl+Shift+P,输入Configure Display Language - 从下拉列表中明确选择
zh-cn(小写、短横线、不能是zh-hans、zh_CN、Chinese或带空格的"zh-cn ") - 点击
Restart(不是Reload Window)——这一步会终止所有后台进程并清空语言缓存 - 若命令面板搜不到该命令,说明语言包未注册成功,需重试上一步安装
远程开发或后台残留导致失效怎么办
局域网常见组合是 SSH/WSL 远程开发,本地装了中文包对远程窗口完全无效;另外 Windows/macOS 后台进程残留会导致配置不生效。
- 远程环境必须单独部署:点击右下角状态栏
SSH: xxx→Install 'Chinese (Simplified) Language Pack' in SSH: xxx→ 再运行Configure Display Language选zh-cn→ 重启远程窗口 - Windows:任务管理器杀光所有
Code.exe进程;macOS/Linux:执行pkill -f "Code Helper"和pkill -f "Electron" - 不要手动改
settings.json加"locale": "zh-cn"—— 这个字段在那里不被识别,必须写进locale.json -
locale.json路径必须准确:
Linux:~/.config/Code/User/locale.json
Windows:%APPDATA%\Code\User\locale.json
macOS:$HOME/Library/Application Support/Code/User/locale.json
最容易被忽略的是语言包版本与 VSCode 主程序不匹配:比如用 v1.92 的 .vsix 安装到 v1.95+,可能静默失败或报 Extension is not compatible。务必去官网下载对应 VSCode 版本的 vscode-language-pack-zh-hans-*.vsix,别贪快用旧包凑合。


















