最可靠方式是用官方Marketplace下载的.vsix文件安装，因其经VSCode官方兼容性验证；命令行code --install-extension比图形界面更稳，失败时明确报错便于排查，且需确保code已加入PATH、路径含空格时加双引号。
直接用 .vsix 文件安装最可靠
VSCode 官方只保证 .vsix 格式离线包的兼容性，其他方式（比如复制 extensions 文件夹）容易因版本不匹配、签名校验失败或依赖缺失导致插件不加载。尤其在 VSCode 1.80+ 版本后，扩展启动逻辑强化了元数据验证，直接拷贝文件夹大概率会静默失效。
实操建议：
- 在能联网的机器上，访问 VSCode Marketplace，搜索目标插件（如
ms-python.python），点击“Download Extension”下载.vsix文件 - 注意核对页面右上角显示的 VSCode 兼容范围（例如
^1.75.0），确保与离线机上的code --version输出一致 - 某些插件（如
ms-vscode-remote.remote-ssh）有平台特定构建，Windows 下下载的.vsix不能直接用于 Linux 离线机
命令行安装 code --install-extension 比图形界面更稳
图形界面的“Install from VSIX”在离线环境下偶发卡死或无响应，尤其当插件含大量资源或需要解压时；而命令行调用是底层直通，失败时会明确报错（如 Extension 'xxx' is not compatible with Code '1.82.2'），便于快速定位问题。
使用要点：
- 确保
code命令已加入系统 PATH（Windows 可在 VSCode 设置中勾选 “Add to PATH”；macOS/Linux 安装时默认勾选） - 路径中含空格或中文时，必须用双引号包裹：
code --install-extension "D:\vsix\ms-python.python-2024.6.0.vsix" - 一次安装多个插件可写成脚本，例如 PowerShell 中：
Get-ChildItem .\extensions\*.vsix | ForEach-Object { code --install-extension $_.FullName }
手动下载旧版插件要改 URL，不能只靠市场页
Marketplace 页面默认只提供最新版 .vsix 下载链接，但离线环境常运行旧版 VSCode（如 1.79.x），而新版插件可能已放弃对该版本的支持。此时必须手工构造历史版本下载地址。
正确做法：
- 先在联网机上打开同版本 VSCode，搜索该插件，在扩展详情页右键“复制链接地址”，得到类似：
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/ms-python/vsextensions/python/2024.8.0/vspackage - 将 URL 中的版本号（
2024.8.0）替换成你所需的旧版本号（如2023.10.0），然后在浏览器中访问新链接并下载 - 版本号需从插件发布历史中确认，推荐查 GitHub Release 页面 或插件作者的 Changelog
装完别急着重启，先检查 Developer: Show Running Extensions
很多用户装完以为成功，结果调试时发现断点不生效、语法高亮没反应——其实插件根本没真正激活。VSCode 启动时会对扩展做动态加载校验，部分插件（尤其是语言服务器类）会在首次打开对应文件类型时才初始化。
验证步骤：
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入并执行Developer: Show Running Extensions - 在弹出列表中查找目标插件名，确认其状态为
Active而非Inactive或空白 - 若状态异常，打开开发者工具（
Help → Toggle Developer Tools），看 Console 是否有ERR级错误，常见如Cannot find module 'vscode'（说明插件编译目标版本不匹配）
真正麻烦的不是装不上，而是装上了却在后台静默挂掉——这点在 Python、Java、Rust 等语言扩展上特别容易被忽略。
