浅析VSCode插件离线安装的数据流向-VSCode-PHP中文网

vscode离线安装插件时，.vsix文件由主进程直接解压并注入扩展注册表，全程不联网；关键依赖目录名严格匹配publisher.name-version格式、package.json中engines.vscode版本兼容，且需满足activationevents条件才能激活。

浅析vscode插件离线安装的数据流向

离线安装 VSCode 插件时，数据根本不经过 Marketplace 服务器——所有传输只发生在你本地文件系统与 VSCode 主进程之间。

VSCode 不会“解析”或“联网校验”你提供的 .vsix 文件，而是直接解压并注入扩展注册表。整个过程完全离线，但依赖两个关键环节：

code --install-extension 命令调用的是 VSCode 主进程（Code.exe / Code），不是渲染进程，因此不走网络栈
解压后，VSCode 将扩展目录（如 ms-python.python-2023.10.0）写入 ~/.vscode/extensions/，并读取其中的 package.json 来注册激活事件、贡献点和依赖声明
如果该扩展声明了 extensionDependencies，VSCode 会在启动时检查这些依赖是否已安装——但不会自动下载，仅报错或禁用主扩展

常见原因不是数据流问题，而是元数据或路径状态不一致：

VSCode

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

下载

扩展目录名必须严格匹配 publisher.name-version 格式，否则 VSCode 启动时不扫描（例如把 ms-python.python-2023.10.0.vsix 手动解压到 python-ext/ 就无效）
package.json 中的 engines.vscode 字段若高于当前 VSCode 版本，安装会静默失败（无提示），可通过 code --list-extensions --show-versions 验证是否真被识别
Windows 下若用普通 CMD 运行 code 命令但未勾选“Add to PATH”，实际调用的是旧版 VSCode 或系统残留的 code.cmd，导致扩展装到错误用户目录

VSCode 本身不提供离线依赖解析能力，所谓“依赖”只是静态声明，没有运行时拉取机制：

如果你安装 esbenp.prettier-vscode，它在 package.json 中声明依赖 esbenp.prettier，这只是提示你需要手动装后者，VSCode 不会尝试从任何地方下载
批量部署时，必须先用 code --list-extensions 导出完整列表，再逐个下载对应 .vsix，顺序无关紧要，但缺失任一依赖都可能导致功能异常
某些扩展（如 ms-python.python）会附带二进制工具（如 pyright），这些是打包进 .vsix 的，无需额外下载——但若扩展更新后改用远程下载模式（如通过 fetch() 动态加载语言服务），离线时就会失败