图形界面“Install from VSIX”在断网时大概率失效，因其依赖网络校验签名、查询元数据并触发远程解压逻辑，断网即静默中断；唯一可靠方式是使用code --install-extension命令行安装，可跳过市场交互、直读文件注册，并明确报错定位路径、版本或CLI配置问题。
断网时点“Install from VSIX”基本等于白点——它依赖后台网络校验签名和触发解压，断网即静默失败；唯一可靠路径是用 code --install-extension 命令行安装，能立刻报错、精准定位问题。
为什么图形界面安装在断网时大概率失效
VSCode 扩展面板的“Install from VSIX”按钮不是纯本地操作。它会在拖入或选择 .vsix 文件后，尝试连接 marketplace.visualstudio.com 校验签名、查询元数据、甚至触发远程解压逻辑。一旦网络不通，整个流程中断，但 UI 不提示、不报错、也不回退，看起来像“点了没反应”。这不是 bug，而是设计使然——微软默认假设你有网。
- 静默失败最常发生在企业内网、高权限策略终端、WSL 内离线子系统中
- 即使 .vsix 文件本身完整，也会卡在“正在验证”状态栏，持续几秒后消失，扩展列表无变化
- Output 面板里切到 “Extensions” 通道，可能看到
Failed to fetch marketplace metadata或空日志
必须用 code --install-extension 命令行安装
命令行是 VSCode 官方支持的离线安装入口，跳过所有市场交互，直读文件、解压、注册。失败时会明确输出错误，比如 Extension is not compatible with Code 或 ENOENT，方便你立刻判断是路径错、版本不匹配，还是 CLI 没注册。
- 先关闭所有 VSCode 进程：Windows 上运行
code --status确认无残留，macOS/Linux 可用ps aux | grep code - 确保
code命令可用：若提示command not found: code，在 VSCode 中按Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH并执行 - Windows 路径含空格必须加双引号：
code --install-extension "D:\vsix\ms-python.python-2024.6.0.vsix" - macOS/Linux 用绝对路径即可：
code --install-extension /Users/me/vsix/prettier-9.10.0.vsix
装完不生效？三个硬性检查点
命令行返回 “Extension installed successfully” 只代表文件已解压进 ~/.vscode/extensions/，不代表插件能干活。尤其 Python、Vue、安全类插件，普遍在首次打开对应文件时才拉语言服务器或分析器，断网就卡住不动。
- 打开一个
.py文件，看状态栏是否显示 “Initializing Pylance…” —— 若一直转圈，去 Output 面板切到Pylance通道，大概率看到Failed to fetch https://.../pylance-release - Python 插件依赖的
python.defaultInterpreterPath必须显式设为有效路径（如venv/bin/python），否则连基础语法高亮都不可用 - Vue 项目装了 Volar，得手动点右下角 Vue 图标 →
Take Over Mode，否则.vue文件仍当普通文本处理
离线环境最容易被忽略的依赖陷阱
插件不是孤岛。很多核心功能依赖外部二进制、本地 CLI 或预置规则包，这些在断网时不会自动下载，也不会报错提醒你缺东西。
- SonarLint 离线只带极简内置规则，OWASP Top 10 类漏洞检测全失效；需提前从有网机器下载对应语言规则包（如
sonarpython），手动放进~/.vscode/extensions/sonarlint.sonarlint-vscode-*/rules/ - Snyk 插件必须提前在有网机器运行
snyk auth --interactive=false生成 token，再拷贝.snyk文件到离线机对应路径，并设权限chmod 600 ~/.snyk - ESLint 插件默认走全局
eslint，但项目通常用本地版；需确认package.json存在且已运行npm install，并设置eslint.packageManager为npm或pnpm
离线安装插件真正的难点不在“怎么装”，而在“装完能不能跑”。每次装完，务必打开对应类型文件（.py、.vue、.js）观察状态栏、Output 面板和右下角语言图标，否则很容易以为成功了，结果调试时才发现 LSP 根本没起来。
