离线安装SVG预览扩展关键在版本匹配、签名验证和策略许可：需用Marketplace直链下载johnstoncode.svgeditor.vsix（如2.10.1版），命令行安装加--allow-unverified参数，且须同步安装依赖ms-vscode.vscode-typescript-next，打开真实UTF-8编码.svg文件并手动启用扩展。
离线安装 SVG 预览扩展（如 johnstoncode.svgeditor）的关键不是“能不能装”，而是你拿到的 .vsix 文件是否匹配当前 VSCode 版本、是否含有效签名、是否被策略拦截——这三个点卡住，界面点不动、命令行报错、装完不显示预览按钮，全都会发生。
怎么拿到真正可用的 johnstoncode.svgeditor.vsix
别信 GitHub Release 页面或第三方镜像站的下载链接。该扩展在 Marketplace 的官方 ID 是 johnstoncode.svgeditor，正确直链必须带 publisher 和 version，格式为：https://marketplace.visualstudio.com/_apis/public/gallery/publishers/johnstoncode/vsextensions/svgeditor/2.10.1/vspackage
其中 2.10.1 是当前最新稳定版（截至 2026 年 9 月），需手动核对：
• 打开 https://marketplace.visualstudio.com/items?itemName=johnstoncode.svgeditor
• 滚动到右下角 Resources → 点击 “Download Extension”
• 复制跳转后的真实 URL，确认末尾是 /vspackage 且含准确版本号
• 下载后校验文件大小：正常应为 1.2–1.5 MB；小于 500 KB 基本是 HTML 错误页
code --install-extension 安装失败的三个高频原因
即使文件是对的，命令行也常静默失败或报模糊错误。真实卡点如下：
• code 命令不可用？不是没配 PATH，而是 VSCode 未注册 Shell Command：按 Ctrl+Shift+P → 输入 Shell Command: Install 'code' command in PATH → 回车执行
• 报错 INVALID_SIGNATURE？离线环境无法连接微软证书服务器，必须加 --allow-unverified 参数：code --install-extension ./johnstoncode.svgeditor-2.10.1.vsix --allow-unverified
• 装完打开 SVG 文件仍无预览面板？不是插件没装上，而是它依赖 ms-vscode.vscode-typescript-next（用于解析内联 script），需一并下载安装
装完 SVG 预览不生效？检查这三处硬性条件
该扩展不会自动激活，必须满足全部条件才显示右上角「Preview」按钮：
• 当前打开的是真实 .svg 文件（不是 .svg.txt 或未保存的 Untitled-1）
• 文件编码为 UTF-8（含 BOM 会触发解析失败，VSCode 右下角状态栏可查看并点击切换）
• 工作区未禁用该扩展：在扩展面板搜索 svgeditor，确认右侧启用开关是蓝色而非灰色；若灰了，点一下手动启用
• 补充：如果 SVG 含大量 JS 或外部 <script src="...">，预览将自动禁用脚本执行（安全限制），此时只渲染静态结构——这不是 bug，是设计行为
最容易被忽略的是版本锁死：该扩展的 package.json 中声明了 "engines": {"vscode": "^1.80.0"}，如果你的 VSCode 是 1.79.x，即使强行装上也会在启动时被静默禁用，且不报任何提示。务必先查 VSCode 版本（Help → About），再选对应兼容的扩展版本。
