vscode插件市场无真正离线模式,所谓“离线”实为网络请求失败后的被动降级;根本解决需同步配置extensions.gallery.serviceurl与cacheurl为国内镜像源(如https://vscode.cdn.azure.cn/extensiongallery/extensiongallery/),并彻底退出所有code及code helper进程后重启。

VSCode 插件市场“离线模式”根本不存在——它没有真正的离线开关,所谓“离线”只是网络请求失败后的被动降级状态,界面卡住、搜索无响应、安装按钮灰掉,都是因为 extensions.gallery.serviceUrl 还在死连不可达的 marketplace.visualstudio.com。
为什么改了 http.proxy 还是加载不出插件列表
因为插件市场页面(搜索框、扩展列表、安装按钮)压根不读 http.proxy 配置。这个字段只影响语言包下载、自动更新检查等次要后台请求,对主市场流量完全无效。你填了 "http.proxy": "http://127.0.0.1:7890" 却依然转圈,不是代理没开,而是 VSCode 根本没把请求发过去。
- 真正控制市场地址的是
extensions.gallery.serviceUrl和extensions.gallery.cacheUrl,二者必须同时设、路径必须一致、末尾必须带/ - 常见错误:只配 serviceUrl、漏掉 cacheUrl → publisher 列表空白;URL 少一个斜杠 → 静默返回 404,界面卡死不报错
- 大小写敏感:
extensionGallery写成extensiongallery或ExtensionGallery都会失败
换镜像源后还是没反应?进程没杀干净
VSCode 后台服务(Code Helper)会缓存旧的市场地址,改完 settings.json 后只点「重新加载窗口」或关掉所有窗口,完全无效。新配置根本不会加载。
- Windows:右键任务栏图标 →「退出」;再进任务管理器,手动结束所有
Code.exe和Code Helper.exe - macOS:打开「活动监视器」,搜索并强制退出全部
Code和Code Helper进程 - Linux:执行
pkill -f "code"或killall -9 code - 命令行启动的用户注意:
code --new-window不等于重启,必须杀进程再重开
离线安装 .vsix 时提示 “Not compatible” 或 “Corrupted ZIP”
这不是文件损坏,而是 VSCode 1.77+ 启用了强校验机制:版本号、架构、签名三者必须全部匹配,缺一不可。
- 先运行
code --version,记下主版本(如1.87.2→ 取1.87)和架构(x64/arm64) - .vsix 文件名里的版本需满足
"engines": {"vscode": "^1.75.0"}中的约束(即 ≥1.75.0 且主版本 ≤ 本地主版本) - 下载直链必须带
&targetPlatform=win32-x64(Windows)、&targetPlatform=darwin-arm64(M系列 Mac)等参数,否则可能下错架构 - 安装后检查
%USERPROFILE%\.vscode\extensions\(Windows)或~/.vscode/extensions/(macOS/Linux)下是否真解压出完整目录,而非仅留一个 .vsix 文件
最常被忽略的一点:Vue、Python 等插件依赖的语言服务器(如 Volar、Pylance)不会随主插件自动下载,离线时必须单独下载对应 .vsix 并手动安装,否则功能残缺但无报错。











