vscode不存在独立“离线文档插件”类别，实际由vscode-pdfviewer、vscode-office、tinymist等具体插件实现本地文档预览与渲染；必须提前从github releases、open-vsx或官方市场直链获取合法.vsix文件，并严格校验扩展名、系统依赖、启用状态及隐式依赖。
VSCode离线文档插件本身不存在独立“离线文档”类型
VSCode 没有官方定义的「离线文档插件」这个类别。所谓“离线文档”，实际是靠具体插件实现的——比如 vscode-pdfviewer 预览本地 PDF，vscode-office 打开 Word/Excel，tinymist 渲染本地 Markdown 或 Typst 源码生成 PDF。它们不依赖网络，但必须以 .vsix 形式安装，且功能各不相同。
离线文档类插件怎么找？认准三个来源
在没有联网的机器上无法访问 Marketplace，所以必须提前从以下三处之一获取合法 .vsix 文件：
- 插件 GitHub 仓库的
Releases页面（最常见）：例如vscode-pdfviewer在 https://www.php.cn/link/402f8a98015c98239e0ad673fd349880 提供带.vsix的发布包 - Open-VSX 仓库（开源友好）：搜索 https://www.php.cn/link/87399f176ecbb33c635159c25c156c7f，输入插件名，点结果页右上角
Download按钮，得到的是标准.vsix - VS Code 官方市场直链（需构造）：把 Marketplace 页面 URL 中的
items替换为vsix，例如https://marketplace.visualstudio.com/items?itemName=telesoho.vscode-markdown-paste-image→ 改成https://marketplace.visualstudio.com/vsix?itemName=telesoho.vscode-markdown-paste-image，浏览器打开即下载（仅对支持该机制的插件有效）
装完不生效？重点检查这三点
即使 .vsix 文件正确，离线安装后也可能看不到 PDF 或 Office 预览，常见卡点如下：
-
vscode-pdfviewer要求文件扩展名严格匹配：必须是.pdf，不能是.PDF或带空格的report .pdf；大小写敏感且路径不能含非法字符 -
vscode-office依赖系统级二进制：Windows 上需已安装 Microsoft Office 或 LibreOffice，macOS/Linux 则可能因缺少soffice命令而静默失败（查开发者工具 Console 是否报spawn soffice ENOENT） - 插件未启用：离线安装后默认处于“已安装但禁用”状态，必须手动点击扩展面板里的启用图标（圆圈内带对勾），否则双击文件无反应
企业或团队批量管理时最容易忽略的细节
离线环境不是只拷一个 .vsix 就完事。真正落地时，以下几项常被跳过，导致新成员反复踩坑：
- 依赖插件没一并下载：例如
tinymist依赖ms-python.python（用于 Python 后端服务），缺一个就启动失败，日志里只显示Extension host terminated unexpectedly - 版本锁死没记录：
vscode-pdfviewer-1.4.0.vsix可能不兼容 VS Code 1.90+，但文件名不体现最低支持版本，必须去其package.json里查engines.vscode字段 - 用户设置未同步：
pdf-preview.default.scale这类配置存在settings.json里，不在extensions目录下，离线迁移时容易漏掉
