第一步是先在有网机器上获取正确的.vsix文件：打开marketplace对应插件页面（如bierner.markdown-preview-github-styles），点击右侧“download extension”按钮下载，或用codex+taotoken自动拼出带targetplatform参数的直链；务必核对publisher.name与版本号，保留原始文件名，避免下错包。
怎么拿到流程图插件的 .vsix 文件
离线安装的第一步不是打开 VSCode，而是先在有网机器上拿到正确的 .vsix 文件。流程图类插件常见有 esbenp.prettier-vscode（配合 Mermaid）、bierner.markdown-preview-github-styles（渲染 Mermaid 图）、vsls-contrib.mermaid-editor 或官方推荐的 james-yu.latex-workshop（含 TikZ 支持）——但注意：这些插件 ID 必须和 Marketplace 页面 URL 中的 publisher.id 完全一致。
错误做法是直接搜“流程图”然后点 Download Extension，容易下错包。正确路径是：
- 打开 https://www.php.cn/link/50b217bc4acdaeb702d8664f214acaf0（以 Markdown 渲染 Mermaid 为例）
- 滚动到右侧 Resources 栏，点击
Download Extension按钮（不是 GitHub Repo 链接） - 浏览器下载的文件名形如
bierner.markdown-preview-github-styles-0.5.11.vsix，保留版本号，别重命名为mermaid.vsix
如果公司策略拦截了 marketplace 域名，就用 TaoToken 接 Codex：把 More Info 页面内容复制给 Codex，它会自动提取 publisher、name、version，再拼出直链，例如：https://marketplace.visualstudio.com/_apis/public/gallery/publishers/bierner/vsextensions/markdown-preview-github-styles/0.5.11/vspackage?targetPlatform=win32-x64。注意末尾 ?targetPlatform= 要匹配你内网机器的系统架构（win32-x64 / linux-x64 / darwin-arm64）。
拖拽安装比右键菜单更可靠
很多用户卡在「点了从 VSIX 安装却没反应」，其实是因为 VSCode 状态不满足 GUI 安装前提。拖拽方式绕过所有策略检查，成功率最高：
- VSCode 必须已启动，并且打开了任意文件夹（哪怕空文件夹），不能是纯欢迎页
- 窗口要有焦点，不能处于全屏、远程 SSH 连接未建立、或多显示器缩放偏移状态
- 把未解压的
bierner.markdown-preview-github-styles-0.5.11.vsix文件，直接拖进 VSCode 的主编辑区（不是侧边栏、不是设置页、不是终端面板） - 松手后弹出确认框，点 Install，完成后右下角提示「Extension installed」
如果拖不进去，先看右下角状态栏是否显示 Extensions disabled by policy —— 这是企业组策略强制禁用，GUI 和 CLI 都会失效，只能走手动解压方案。
命令行安装必须用绝对路径 + 正确参数
code --install-extension 看似简单，但 Windows 下路径含空格、Linux/macOS 用相对路径、或 code 命令未注册，都会失败：
- Windows：命令行中路径必须加双引号，例如
code --install-extension "C:\tools\ext\bierner.markdown-preview-github-styles-0.5.11.vsix" - Linux/macOS：必须用绝对路径，例如
code --install-extension /home/user/vscode-ext/bierner.markdown-preview-github-styles-0.5.11.vsix - 若提示
command not found: code，说明 CLI 未注册：在 VSCode 中按Ctrl+Shift+P，输入Shell Command: Install 'code' command in PATH并执行 - 想覆盖旧版本，加
--force参数：code --install-extension xxx.vsix --force
安装后插件默认是禁用状态，必须手动点击启用，否则 Mermaid 代码块不会渲染。语言类插件首次启用还会尝试下载 LSP，离线环境会卡在 Downloading...，此时需提前配置好本地 LSP 可执行文件路径（如 markdown.preview.mermaidPath 指向本地 mermaid-cli）。
手动解压直装是最后手段，结构不能错
当 GUI 和 CLI 全被组策略封锁，或插件带 native 二进制（比如某些流程图渲染器依赖 node-gyp 编译产物），只能解压直装。这不是复制粘贴，而是严格还原目录结构：
- 先用
unzip -l your-extension.vsix查顶层目录名，例如输出里第一行是bierner.markdown-preview-github-styles-0.5.11/—— 这就是扩展 ID + 版本号，必须原样作为子目录名 - 解压整个 vsix 到临时目录，得到完整文件夹（含
package.json、node_modules、dist等） - 把这个文件夹整体移到对应 extensions 目录：
Windows：%USERPROFILE%\.vscode\extensions\
macOS/Linux：$HOME/.vscode/extensions/
漏掉 node_modules 或改错文件夹名，VSCode 启动时会静默忽略该插件，连日志都不报——这是最隐蔽的失败点。
