VSCode 1.80+ 内网无法连接官方市场，因其强制使用内置网络栈绕过系统代理和HTTP_PROXY，导致getGalleryServiceUrl failed等错误；唯一有效方案是自建vscode-extension-marketplace-server私有服务，并通过extensions.gallery.serviceUrl等配置项指向该服务。
为什么官方市场在局域网里根本连不上
VSCode 1.80+ 版本强制使用内置网络栈请求 https://marketplace.visualstudio.com，绕过系统代理和全局 HTTP 代理设置。哪怕你配了公司级反向代理，getGalleryServiceUrl failed 或 Unable to fetch extensions 这类错误依然会出现——不是配置没生效，是 VSCode 根本不走那条路。
常见误区包括：试图用 http-proxy 环境变量、修改系统 hosts、或让 IT 部门开放 marketplace 域名白名单。这些对新版 VSCode 全无效。唯一正解是自建一个协议兼容的私有服务，让客户端“以为”它就在连官方市场。
用 vscode-extension-marketplace-server 搭个最小可用私服
社区中轻量、免数据库、启动即用的方案只有 vscode-extension-marketplace-server（注意不是同名但已废弃的老项目）。它靠内存索引 + 静态 .vsix 文件工作，适合内网快速落地。
- 必须用 Node.js 16+（LTS 版本），
npm install -g vscode-extension-marketplace-server -
.vsix文件统一放一个目录，比如/opt/vscode-extensions/，支持子目录嵌套 - 启动命令里
--host 0.0.0.0必须显式指定，否则默认只绑127.0.0.1，其他机器访问不到 - 端口别用 80 或 443（常被占用），推荐
--port 8080；若被占，VSCode 客户端不会 fallback，直接失败 - 启动后访问
http://your-server:8080应返回 JSON 格式的元信息，才算真正就绪
VSCode 客户端怎么认出你的私服
VSCode 不提供图形界面切换市场源，只能靠配置项硬覆盖。关键就两个：
-
extensions.gallery.serviceUrl：必须指向http://your-server:8080/api/gallery（结尾带/api/gallery） -
extensions.gallery.recommendationsUrl：同样指向http://your-server:8080/api/gallery/recommendations - 配置位置：Linux/macOS 是
$HOME/.vscode/settings.json，Windows 是%USERPROFILE%\AppData\Roaming\Code\User\settings.json - 改完不用重启 VSCode，但必须关闭所有窗口再重开，否则旧连接缓存可能卡住
如果装完插件后命令面板搜不到对应功能，打开 Help > Toggle Developer Tools，看 Console 是否报 Failed to load extension 或路径 404 —— 大概率是 serviceUrl 少写了 /api/gallery 后缀。
离线插件包怎么进你的私服
从外网获取 .vsix 是刚需，但不能随便下。要注意三点：
- 优先从官方市场页面点
Version History下载，URL 形如https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csharp→ 点历史版本 → 找到对应.vsix链接 - 别用第三方打包站或网盘链接，校验风险高；金融、政务等场景建议额外比对 GitHub Release 页面的
sha256sum - 放进私服前，用 7-Zip 直接打开
.vsix，检查内部package.json的engines.vscode字段是否匹配局域网内统一部署的 VSCode 版本（例如"^1.80.0"），不匹配会静默失败
最常被忽略的是 engines.vscode 兼容性。很多团队搭好私服却装不上插件，查日志发现全是 Extension 'xxx' is not compatible with Code '1.85.0' —— 问题不在服务端，而在那个被拖进去的 .vsix 本身。
