VSCode断网启动卡在“正在检查扩展更新”是因为默认启用extensions.autoCheckUpdates，同步请求marketplace导致主进程阻塞；必须同时设extensions.autoCheckUpdates和extensions.autoUpdate为false，并完全退出进程才生效。
VSCode 在内网或断网环境下启动卡在“正在检查扩展更新”，本质是它仍会同步发起 marketplace 请求，而非插件本身加载失败；禁用自动检查和自动更新两项配置必须同时生效，且需完全退出进程才真正起效。
为什么断网时 VSCode 启动就卡住转圈
默认情况下，VSCode 启动时会同步调用 marketplace.visualstudio.com 检查所有已安装插件的更新状态。哪怕你没开自动更新，只要 extensions.autoCheckUpdates 为 true（默认值），这个 HTTP 请求就会阻塞主进程 10–30 秒。现象包括：窗口无响应、活动指示器持续旋转、快捷键失灵、甚至集成终端无法输入。
这不是插件损坏，也不是扩展宿主崩溃——打开开发者工具（Ctrl+Shift+P → Developer: Toggle Developer Tools），切到 Network 标签页，重启 VSCode，就能看到大量 https://marketplace.visualstudio.com/... 请求处于 pending 状态。
-
extensions.autoCheckUpdates: false关闭启动时的同步探测 -
extensions.autoUpdate: false关闭后台静默更新行为 - 二者缺一不可；只关一个，卡顿依旧
- 设置必须写入
settings.json，GUI 设置容易漏掉隐藏项
如何彻底禁用 Marketplace 联网行为
直接编辑用户级 settings.json 是最可靠的方式。路径如下：
- Windows：
%APPDATA%\Code\User\settings.json - macOS：
$HOME/Library/Application Support/Code/User/settings.json - Linux：
$HOME/.config/Code/User/settings.json
加入以下两行（注意末尾逗号，若已有其他配置需补全）：
"extensions.autoCheckUpdates": false, "extensions.autoUpdate": false
改完保存后，**必须完全退出 VSCode 进程**：Windows 右键任务栏图标选“退出”，macOS 在 Activity Monitor 中杀掉所有 Code 和 Code Helper 进程，Linux 执行 killall -9 code。否则设置不会热加载，卡顿照旧。
内网环境还想装新插件？绕过 Marketplace 的三种实操路径
禁用联网只是让现有插件不卡，但没法解决“想装新插件却连不上市场”的问题。以下是真实可用的替代方案：
- 用国内镜像源替换默认市场：在
settings.json中添加"extensions.gallery.serviceUrl": "https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/"，重启后扩展面板即可搜索安装（注意 URL 末尾必须有/） - 手动下载
.vsix文件离线安装：在有网机器上访问插件页，点 “Download Extension”，传入内网后用code --install-extension /path/to/plugin.vsix安装；路径不能含中文或空格，否则静默失败 - 批量固化环境：用
vsce download ms-python.python@2024.10.1精确拉取指定版本（需先npm install -g @vscode/vsce），适合审计或 CI 场景
最容易被忽略的兼容性陷阱
即使插件成功装进去了，也可能在断网环境下首次启用时报错或静默失效——尤其是 Remote-SSH、Python、C++ 这类重度依赖远端服务或本地二进制的插件。它们往往自带版本校验逻辑，且不依赖 Marketplace 连接：
- Remote-SSH 插件会在远端部署
vscode-server，其版本必须与本地 VSCode 主版本严格一致（如本地是1.79.2，远端~/.vscode-server目录就得对应重建） - 某些插件（如 Vetur）内部调用已废弃的 Webview API，仅改
engines.vscode字段无效，必须降级 VSCode 或换插件 - 全局 Python/pip 版本冲突：旧版插件可能依赖 pip 21.x，而系统已升到 24.x，需在 VSCode 集成终端中执行
python -m pip install --upgrade pip==21.3.1
这些不是网络问题，但常被误判为“断网导致插件异常”——排查时得先确认是否真连不上，再看是不是本地运行时环境出了岔子。
