一键脚本实现VSCode插件离线安装的构想-VSCode-PHP中文网

vscode插件离线安装无法全自动完成，因无统一离线格式且依赖marketplace元数据；code --install-extension命令仍需联网验证publisher、签名及兼容性，断网即失败；实操须提前下载.vsix、禁用自动更新、加--force参数，并手动处理平台专属二进制依赖。

一键脚本实现vscode插件离线安装的构想

VSCode 插件离线安装不能靠“一键脚本”全自动完成，核心障碍在于插件本身没有统一的离线分发格式，且依赖 VS Code 内部扩展协议和 Marketplace 元数据。所谓“一键”，最多能做到半自动搬运 + 本地安装触发，必须人工介入确认来源、校验完整性、处理依赖链。

为什么 `code --install-extension` 无法直接离线安装

这个命令本质是在线调用 VS Code 的扩展服务：它会解析传入的 .vsix 文件，但随后仍会向 marketplace.visualstudio.com 发起请求，验证 publisher、版本签名、兼容性（如 engines.vscode），甚至拉取 README 或图标。若网络不通或域名被拦截，安装直接失败并报错 Unable to fetch extension information 或 connect ECONNREFUSED。

实操建议：

必须先用有网环境下载纯净 .vsix（推荐从插件详情页右键“Download Extension”）
禁用自动更新和遥测：在离线机器的 settings.json 中设 "extensions.autoUpdate": false 和 "telemetry.enableTelemetry": false
运行命令时加 --force 参数绕过部分校验：code --install-extension path/to/xxx.vsix --force

如何批量安装多个 `.vsix` 文件（Linux/macOS 常用方案）

离线场景下，你手头通常是一堆已下载好的 .vsix 文件。VS Code 不支持通配符安装，需逐个调用 code --install-extension。脚本只能做封装，不能替代人工校验。

一个可用的 Bash 片段：

VSCode

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

下载

for f in *.vsix; do
  echo "Installing $f..."
  code --install-extension "$f" --force 2>/dev/null || echo "Failed: $f"
done

注意点：

2>/dev/null 屏蔽网络错误日志，避免误判失败（实际可能已装上）
务必在目标机器上先执行 code --list-extensions 确认 VS Code CLI 已正确注册到 PATH
Windows 用户需改用 PowerShell：Get-ChildItem *.vsix | ForEach-Object { code --install-extension $_.FullName --force }

插件依赖和平台差异是离线安装最大的隐形坑

很多插件（尤其是带 native binary 的，如 ms-python.python、ms-vscode.cpptools）会在安装时动态下载平台专属二进制（win32-x64、darwin-arm64 等）。这些资源不包含在 .vsix 内，离线时会卡在 “Downloading package…” 并超时。

解决路径有限：

提前在同架构、同系统版本的联网机器上完整安装一次该插件，然后复制整个扩展目录（路径类似 ~/.vscode/extensions/ms-python.python-2024.x.x/）到离线机对应位置
检查插件文档是否提供 “offline bundle” —— 极少数（如 redhat.vscode-yaml）会发布含 runtime 的 ZIP 包
放弃该插件，找纯 JS 实现的替代品（例如用 bierner.markdown-preview-github-styles 替代带预编译依赖的渲染器）

真正麻烦的从来不是“怎么运行脚本”，而是搞清每个插件背后藏了多少没声明的网络请求、二进制依赖和签名验证逻辑。离线环境下，多看一眼 Developer: Toggle Developer Tools 控制台里的 Network 标签页，比写十个“一键脚本”都管用。