旧版 vscode 必须匹配对应版本插件，否则扩展面板灰显、remote-ssh 连接失败、c/c++ 插件报“cannot find module 'vscode'”；可通过固定 url 格式（含 publisher、extension-name、version）手动拼接 vsix 下载地址，或使用 vsix.2i.gs、油猴脚本等工具获取历史版本。
旧版 VSCode 必须配旧版插件，否则扩展面板全灰、Remote-SSH 连不上、C/C++ 插件报 Cannot find module 'vscode'——这不是插件坏了，是版本契约被打破了。
怎么拿到插件的 vsix 下载地址
VS Code Marketplace 官网只展示最近 3–5 个版本，历史版本链接不公开。但所有插件的下载地址有固定结构，只要知道插件 ID 和目标版本号，就能拼出真实下载 URL：
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension-name}/{version}/vspackage- 例如简体中文包：
MS-CEINTL.vscode-language-pack-zh-hans，想下 1.81.2 版本，就填1.81.2到 URL 末尾 - 插件 ID 可在插件详情页 URL 中直接看到，比如
https://marketplace.visualstudio.com/items?itemName=ms-python.python→ ID 是ms-python.python - 版本号来源：点进插件页面 → 滚到底部点
Version History→ 找到匹配你 VSCode 主版本的条目（如 VSCode 1.79.x 通常配插件 2023.x 系列）
如何确认插件版本和 VSCode 版本是否兼容
不是“越新越好”，也不是“随便凑合”。VSCode 主版本和插件编译时依赖的 API 层级强绑定：
- 打开 VSCode →
Help → About→ 记下Commit值（如4b96c15）和完整版本（如1.79.2） - 关键看插件
package.json中的engines.vscode字段：它声明了最低支持的 VSCode 版本（如^1.79.0），低于这个值会静默失败 - Remote-SSH 是重灾区：本地 VSCode 是
1.79.2，远端~/.vscode-server目录里必须也是1.79.2的 server 二进制，否则卡在Starting VS Code Server - 语言类插件（如 C/C++、Python）通常每季度发一个大版本，老 VSCode 往往只能用上一季度的插件，比如 VSCode 1.65 最稳配 Python 插件
2022.12.1
离线安装 vsix 包的实操要点
下载完 .vsix 文件只是第一步，安装过程容易因残留或路径错位失败：
- VSCode 必须关闭后再双击 vsix 安装，否则可能提示
Extension is not compatible（即使版本对得上） - Windows 用户注意：如果之前用过 System Installer 安装 VSCode，插件默认装在
%USERPROFILE%\.vscode\extensions\；User Installer 则可能在%APPDATA%\Code\User\extensions\—— 装错目录会导致启动后不加载 - 更稳妥做法：先手动清空
.vscode/extensions/目录（重命名为extensions-backup），再安装 vsix，让 VSCode 重建干净环境 - 批量安装？终端执行：
code --install-extension path/to/xxx.vsix，支持绝对路径或相对路径
替代方案：第三方 vsix 下载站与脚本工具
手拼 URL 太费劲，尤其要批量适配多个插件时，推荐两个经验证可靠的替代路径：
-
vsix.2i.gs：输入插件 ID（如
ms-python.python）和版本号（如2023.8.1），直接生成可下载链接，无需翻 changelog - 油猴脚本
vscode-plugins-download：安装 Tampermonkey 后启用该脚本，打开 Marketplace 插件页，页面右上角会多出「Download vsix」按钮，点一下就能下载当前显示的版本 - 慎用浏览器插件类下载器（如 Marketplace Downloader），部分已失效或夹带广告，2026 年实测仅 vsix.2i.gs 和油猴脚本稳定可用
最常被忽略的一点：插件不是孤立存在的。C/C++ 插件依赖系统 clangd 或 cpptools server，Python 插件依赖 pylance 和 debugpy，这些子组件也有自己的版本生命周期。只换主插件 vsix，不检查配套服务版本，照样会报错。
