vscode离线安装.vsix插件最简单方式是直接拖入已启动且加载工作区的vscode窗口；命令行用code --install-extension配合绝对路径更可靠；需确保vscode版本兼容，并提前在有网环境下载依赖后整目录迁移。

VSCode离线安装.vsix插件：直接拖进窗口就行

只要 VSCode 已安装，.vsix 文件本身是自包含的，不需要联网校验或下载依赖。最简单的方式就是把文件拖进 VSCode 窗口——它会自动识别并弹出安装确认。别找“扩展市场”入口，那个必须联网。

• 确保目标机器的 VSCode 版本 ≥ 插件 engines.vscode 声明的最低版本（可解压 .vsix 查 package.json）
• 不要双击 .vsix，Windows 默认可能用浏览器打开，或者报“无法安装”
• 如果拖入后没反应，检查 VSCode 是否处于「工作区已加载」状态（空白窗口有时不响应）

命令行安装：用 code --install-extension 更可靠

在内网机器上执行命令行安装，比图形界面更明确、可复现，也方便写脚本批量装多个插件。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 先确认 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 后保存文件是否触发格式化）

离线装插件最难缠的不是安装动作本身，而是那些藏在背后的自动下载逻辑和平台相关二进制——它们不会报错，只会让功能半残，得一个个去输出面板里翻日志才能发现。