VSCode离线安装.vsix插件最简单方式是直接拖入已启动且加载工作区的VSCode窗口；命令行用code --install-extension配合绝对路径更可靠；需确保VSCode版本兼容，并提前在有网环境下载依赖后整目录迁移。
VSCode离线安装.vsix插件：直接拖进窗口就行
只要 VSCode 已安装，.vsix 文件本身是自包含的，不需要联网校验或下载依赖。最简单的方式就是把文件拖进 VSCode 窗口——它会自动识别并弹出安装确认。别找“扩展市场”入口，那个必须联网。
- 确保目标机器的 VSCode 版本 ≥ 插件
engines.vscode声明的最低版本（可解压.vsix查package.json） - 不要双击
.vsix，Windows 默认可能用浏览器打开，或者报“无法安装” - 如果拖入后没反应，检查 VSCode 是否处于「工作区已加载」状态（空白窗口有时不响应）
命令行安装：用 code --install-extension 更可靠
在内网机器上执行命令行安装，比图形界面更明确、可复现，也方便写脚本批量装多个插件。
- 先确认
code命令可用：终端运行code --version，若提示未找到，需把 VSCode 安装目录下的bin（Linux/macOS）或resources/app/bin（Windows）加进PATH - 安装命令：
code --install-extension /path/to/xxx.vsix（路径必须是绝对路径，Windows 用正斜杠或双反斜杠） - 安装失败时，终端会输出具体错误，常见如
Extension 'xxx' is not compatible with Code，说明版本不匹配
插件依赖和 native 模块可能失效
很多插件（比如 ms-python.python、esbenp.prettier-vscode）会在首次启用时自动下载额外语言服务器或二进制工具（如 pyright、prettier CLI），这些行为默认走外网，离线环境会卡住或报错。
- 这类插件安装后，首次打开对应文件类型（如
.py）时，状态栏可能显示“Downloading…”并长时间无响应 - 解决办法：提前在有网机器上启动一次该插件，让它下完依赖；然后把插件目录整个拷过去——路径通常是
~/.vscode/extensions/xxx-yyy-zzz（Linux/macOS）或%USERPROFILE%\.vscode\extensions\（Windows） - 注意：不能只拷
.vsix，要拷解压后的完整文件夹，否则 native 二进制缺失
验证是否真装好了：别只看扩展列表
VSCode 扩展面板里显示“已安装”，不代表能用。有些插件需要重启 VSCode，有些要打开特定文件类型才激活，还有些会静默失败。
- 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），输入插件相关命令（如Python: Select Interpreter），看能否调出 - 检查输出面板（
View → Output），切换到对应插件名称的通道（如Python、Prettier），看有没有报Failed to fetch或spawn ENOENT - 如果插件带设置项，在
settings.json里手动加配置后保存，观察是否生效（比如改"editor.formatOnSave": true后保存文件是否触发格式化）
