vscode 官方不提供开箱即用的完整离线安装包,可靠方案是分别下载官方安装程序、中文语言包(ms-ceintl.vscode-language-pack-zh-hans)和插件的 .vsix 文件,确保签名有效、版本匹配、路径纯净后离线安装。

VSCode 官方不提供“开箱即用”的完整离线安装包(含编辑器 + 所有常用插件 + 中文包打包在一起的单一文件),所谓“完整离线包”都是第三方或社区打包的合集,稳定性、签名有效性、版本兼容性均无保障。真正可靠的做法是:分别下载官方 VSCode 安装程序 + 官方语言包 .vsix + 其他插件 .vsix,三者组合才是可控、可验证、可复现的离线方案。
直接下载官方 VSCode 离线安装程序
VSCode 本身支持真正的离线安装,Windows/macOS/Linux 各平台均有独立的免联网安装包,无需额外依赖即可运行:
- Windows 用户访问
https://code.visualstudio.com/sha/download?build=stable&os=win32-x64(64 位)或https://code.visualstudio.com/sha/download?build=stable&os=win32-ia32(32 位),浏览器会自动触发下载VSCodeSetup-x64-*.exe - macOS 用户用
https://code.visualstudio.com/sha/download?build=stable&os=darwin-universal下载VisualStudioCode-darwin-universal.zip - Linux 用户根据发行版选:
https://code.visualstudio.com/sha/download?build=stable&os=linux-deb-x64(.deb)或https://code.visualstudio.com/sha/download?build=stable&os=linux-rpm-x64(.rpm) - 所有链接均为微软 CDN 直链,无需登录,国内访问稳定;若下载慢,可替换域名前缀为
https://vscode.cdn.azure.cn(例如https://vscode.cdn.azure.cn/stable/...)
中文语言包必须单独下 .vsix,且只认 MS-CEINTL.vscode-language-pack-zh-hans
VSCode 的中文界面不是内置功能,而是通过插件实现,且只有 MS-CEINTL.vscode-language-pack-zh-hans 这一个 ID 是官方认可的简体中文包。其他名称(如 chinese-lang-pack、vscode-chinese)即使能装上,也大概率无法切换 UI 语言。
- 务必从官网页面下载:
https://marketplace.visualstudio.com/items?itemName=MS-CEINTL.vscode-language-pack-zh-hans→ 拉到页面底部点 Download Extension,得到形如MS-CEINTL.vscode-language-pack-zh-hans-1.93.2.vsix的文件 - 下载后建议解压检查
package.json中"engines": {"vscode": "^1.93.0"}是否与你本地code --version输出的主版本号匹配(如 1.93.x);不匹配会导致安装成功但重启无效 - 切勿使用百度网盘、聚合镜像站提供的“中文版安装包”,那些多为旧版封装或夹带非签名内容,VSCode 启动时会报
Extension is not signed by Microsoft
插件离线安装必须用 .vsix,别信“一键合集”
所有扩展都以 .vsix 格式分发,没有“VSCode 完整离线包”这种东西。所谓“完整包”通常是把一堆 .vsix 打包压缩,但存在三个硬伤:签名失效、版本错配、路径污染。
- 最稳的下载方式是在有网机器上打开 VSCode → Ctrl+Shift+X → 搜索插件 → 右键插件名 → Download Extension VSIX(注意:此选项仅对未安装过的插件可见;若已装过,开无痕窗口再访问插件页可恢复)
- 需要批量或指定旧版本?用官方直链拼接:
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension_name}/{version}/vspackage,其中publisher是插件页右上角 Publisher 后的 ID(如ms-python),extension_name是 Unique Identifier 小数点后半段(如ms-python.python→ 填python),version必须和 Version History 完全一致 - 安装时用命令行
code --install-extension /path/to/xxx.vsix,但路径不能含中文、空格或 Unicode 字符;否则报ENOENT: no such file or directory;推荐先挪到C:\vsix\或/tmp/vsix/这类纯英文路径
真正麻烦的从来不是下载,而是版本对齐和路径干净——VSCode 对 .vsix 签名、engines.vscode 版本、系统 locale、settings.json 中残留的 "locale" 配置极其敏感。哪怕下载的是官网正版,只要这四者中有一处错位,中文就出不来,插件就灰显。离线部署前,务必在一台测试机上走完“下载→安装→重启→确认生效”全流程。











