vs code插件安装卡住本质是网络连接失败，需改用离线方式：下载兼容版本的.vsix，用命令行code --install-extension安装，或在有网机器预装后复制整个扩展文件夹到离线机。
插件卡在“Downloading…”或“Installing…”不动，本质是网络断了
VS Code 插件安装卡住，90% 以上不是插件本身问题，而是它在后台尝试连接 marketplace.visualstudio.com 或插件自己的 CDN（比如 pyright、prettier CLI 下载地址）失败，但 UI 没给明确提示。你看到的“Installing…”可能已停滞 5 分钟，实际什么都没干。
常见错误现象包括：
- 状态栏右下角一直显示
Downloading Python language server...却无进度 - 点击 Update 后插件列表里图标变灰，再点没反应
- 输出面板（
View → Output）切换到对应插件通道，出现Failed to fetch、network timeout或spawn ENOENT
这时候别等，也别反复点重试——直接切离线路径。
下载 .vsix 包前，先确认版本兼容性
很多卡住其实是 Unable to install extension 'xxx' because it is not compatible with the current version of VS Code 的静默表现。VS Code 不会弹窗报这个错，只卡住。
实操建议：
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力，其中最引人注目的是新增 Copilot CLI 远程控制功能，允许开发者通过手机或网页远程监控和接管 AI 会话 。同时，为了提高 AI 的运行性价比，新版本优化了令牌缓存策略以降低成本 。此外，1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
- 在有网机器上打开 VS Code，按
Ctrl+Shift+P输入Help: About，记下版本号（如1.87.2） - 去 https://www.php.cn/link/3d29fb5278af9da98e9e7c9d3c97b9e2 这类页面，点
Download Extension前，先解压已下载的.vsix文件（用unzip -t xxx.vsix校验），打开里面的extension/package.json，检查"engines": { "vscode": "^1.80.0" }—— 你本地版本必须 ≥ 这个最小值 - 如果目标是内网机器，优先选
targetPlatform参数下载：在插件市场 URL 末尾加&targetPlatform=win32-x64（Windows）、&targetPlatform=linux-x64（Linux）或&targetPlatform=darwin-arm64（M1/M2 Mac）
命令行 code --install-extension 是最可靠的离线安装方式
图形界面拖拽或“Install from VSIX”菜单容易静默失败，尤其当插件含 native 二进制依赖时；而命令行会立刻输出错误原因，适合排障。
执行前确认：
- 终端运行
code --version，若报错，说明code命令未加入 PATH —— 重新打开 VS Code，按Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH启用 - 路径必须是绝对路径：
code --install-extension /home/user/Downloads/ms-python.python-2024.6.0.vsix（Linux/macOS）或code --install-extension "C:\Users\Name\Downloads\ms-python.python-2024.6.0.vsix"（Windows，含空格必须加引号） - 安装失败时终端会明确提示，例如
Extension 'ms-python.python' is not compatible with Code，这时就得换更低版本的 .vsix
装完仍不生效？关键在“依赖是否真落地”
很多插件（如 ms-python.python、rust-lang.rust-analyzer）的 .vsix 只是“启动器”，首次启用时才会去外网下载语言服务器二进制文件。离线环境下，这步必然卡死。
真正能离线用的方案是：
- 在一台**有网且 VS Code 版本一致**的机器上，安装同一 .vsix，然后打开一个
.py文件，等状态栏不再显示 “Downloading…”、输出面板里Python通道出现Starting Pylance server，说明依赖已下全 - 关掉 VS Code，进入该机器的扩展目录：
~/.vscode/extensions/（Linux/macOS）或%USERPROFILE%\.vscode\extensions\（Windows），找到类似ms-python.python-2024.6.0的完整文件夹 - 把这个**整个文件夹**拷到目标离线机的对应
extensions/目录下，重启 VS Code - 验证：按
Ctrl+Shift+P输入Python: Select Interpreter，能调出即成功；否则检查Output → Python是否有spawn ENOENT—— 那说明 native 二进制缺失，得重走一遍“有网机预热”流程
离线环境里，.vsix 文件只是个容器，真正干活的是它解压后目录里那些没出现在市场页面上的二进制和 node_modules —— 忘了这一步，就永远卡在“正在安装”。
