最稳解法是将extensions.gallery.serviceUrl改为国内镜像源并彻底退出VSCode进程；常见失败原因为URL末尾缺斜杠或进程未完全终止；推荐使用open-vsx.org替代微软源，需同时配置serviceUrl和itemUrl。
VSCode 插件市场本身不支持多实例并发请求，所谓“多实例启动报错”实际是多个 VSCode 窗口/进程同时尝试初始化扩展管理器（Extension Host）时，因共享缓存、锁文件或网络连接复用冲突导致的加载失败。这不是插件市场设计缺陷，而是本地资源争用问题。
为什么多窗口打开会触发 extensions.gallery.serviceUrl 请求失败
VSCode 每个新窗口默认会独立拉取插件市场元数据（即使已缓存），若此时主进程的 Extension Host 正在忙于加载或崩溃重启，后续窗口可能读到损坏的 extensionsCache 或无法获取 TLS 会话票据，表现为控制台反复出现 net::ERR_CONNECTION_RESET 或 Failed to fetch。
- 所有窗口共用同一套磁盘缓存目录：
~/.vscode/extensionsCache（macOS/Linux）或%USERPROFILE%\.vscode\extensionsCache（Windows） - 首次窗口启动后，
extensionsCache被写入临时锁文件；第二个窗口若在锁未释放前尝试读取，会静默跳过缓存直接发网路请求 - 多个窗口同时请求
marketplace.visualstudio.com，容易触发企业防火墙的连接频控或 TLS 握手限流
禁用自动扩展同步可避免多实例竞争
VSCode 默认开启「Settings Sync」，一旦登录账号，所有窗口都会尝试同步扩展列表。这会放大多实例下的网络和状态冲突。
- 关闭同步：打开设置（
Ctrl+,），搜索extensions.autoUpdate，设为false - 更彻底：在
settings.json中添加"extensions.ignoreRecommendations": true，阻止工作区推荐插件自动触发市场查询 - 禁用全局同步：命令面板输入
Preferences: Configure Settings Sync→ 点击Turn Off，而非仅暂停
强制单例模式启动防止重复 Extension Host 初始化
VSCode 提供 --reuse-window 参数，确保新打开的文件/文件夹复用已有窗口，而不是新建进程——这是从源头规避多实例竞争最有效的方式。
- 终端启动时统一用：
code --reuse-window /path/to/project - macOS 用户可在 Dock 右键 VSCode 图标 → Options → “Open in New Window” 改为 “Open in Same Window”
- Windows 用户可修改快捷方式目标为：
"C:\Users\xxx\AppData\Local\Programs\Microsoft VS Code\Code.exe" --reuse-window - 注意：
--disable-extensions不能解决此问题，它只是绕过加载，不解决多实例本身
extensionsCache 损坏后手动清理的时机与风险
当多个窗口反复报错且 Developer: Reload Window 无效时，大概率是 extensionsCache 写入中断导致元数据错乱。但不要一出问题就删，它会影响插件更新通知和分类索引。
- 仅在以下情况执行删除：
Console中看到Failed to parse extensions gallery response或Unexpected end of JSON input类错误 - 删除路径：
rm -rf ~/.vscode/extensionsCache（macOS/Linux）或rd /s /q "%USERPROFILE%\.vscode\extensionsCache"（Windows） - 删完必须完全退出所有 VSCode 进程（包括后台的
Code Helper），否则残留进程会立即重建损坏缓存 - 首次重启后插件市场加载会变慢，这是正常现象——VSCode 需重新下载并解析完整扩展索引
多实例问题本质不是“VSCode 启动太多”，而是多个进程对同一套缓存和网络通道的无序争抢。真正稳定的开发习惯是：固定一个主窗口 + --reuse-window 启动新项目 + 关闭自动同步。那些靠频繁开新窗口来“隔离环境”的做法，在扩展生态里反而最容易踩坑。
