VS Code 预览插件（GoMind Viewer）

GoMind Viewer 是 GoMind 的 VS Code 扩展。它把 Markdown、YAML、XMind 和 GoMind 文件渲染为只读思维导图，让你在编辑文档、维护知识库或浏览代码仓库时不必离开 VS Code。

它适合以下场景：

• 一边编写 Markdown 或 YAML，一边查看内容结构；
• 快速阅读 .xmind 或 .gomind 文件；
• 在包含大量导图文件的工作区中快速切换预览。

插件只负责预览。编辑、云同步、AI、导入和导出等操作请使用 GoMind 应用或其他对应工具。

环境要求

• 桌面版 VS Code 1.85 或更高版本。
• Windows、macOS 或 Linux。
• 离线预览不需要网络。GoMind 侧栏中的在线 Web 应用需要联网。
• 当前版本面向在本机打开文件夹或本地文件的桌面版 VS Code。vscode.dev、Remote SSH、Dev Containers 和 Codespaces 未经验证，不建议在这些环境中使用本地文件预览。

安装与更新

从 Marketplace 安装

1. 在 VS Code 中打开扩展视图（Cmd/Ctrl+Shift+X）。
2. 搜索 GoMind Viewer，或扩展 ID POSHGROUPLIMITED.gomind-viewer。
3. 确认发布者为 POSHGROUPLIMITED，选择 安装。
4. 如果 VS Code 提示重新加载窗口，按提示操作。

安装后，活动栏会出现 GoMind 图标。也可以在受支持的文档上右键，确认看到对应的预览命令。

Marketplace 页面：GoMind Viewer

离线或内网安装 VSIX

无法访问 Marketplace 时，可以使用组织提供的 .vsix 安装包：

1. 获取与当前 VS Code 版本兼容的 gomind-viewer-<版本>.vsix。
2. 打开扩展视图，选择视图右上角的 ... → 从 VSIX 安装...。
3. 选择 VSIX 文件，并按提示重新加载窗口。

也可以在终端中执行：

code --install-extension /path/to/gomind-viewer-<版本>.vsix

离线安装后，本地文件预览仍可正常使用；侧栏中的在线 Web 应用入口需要能够访问对应网站。

更新与卸载

在扩展视图中找到 GoMind Viewer，可以检查更新或卸载。更新后如果侧栏图标或命令没有出现，重新加载 VS Code 窗口。

支持的格式

英文界面中的命令名称为 Preview Markdown with GoMind、Preview YAML with GoMind、Preview XMind with GoMind 和 Preview GoMind with GoMind。

打开预览

从当前文件打开

1. 在编辑器中打开文件，或在资源管理器中选中文件。
2. 右键文件，选择对应的 使用 GoMind 预览 ... 命令。
3. 预览会在当前编辑器列中打开。

也可以打开命令面板（Cmd/Ctrl+Shift+P），搜索 Preview ... with GoMind 或 使用 GoMind 预览 ...。

再次预览另一个受支持的文件时，插件会复用同一个 GoMind Viewer 标签页，只更新标题和内容，避免堆积大量预览标签。

从 GoMind 侧栏打开

1. 点击活动栏中的 GoMind 图标。
2. 如果当前活动标签是受支持的文件，点击 预览 <文件名>，一键打开当前文档。
3. 如果只想预览某个文件，点击 选择文件进行预览，从磁盘选择 Markdown、YAML、XMind 或 GoMind 文件。该文件不必位于当前工作区中。
4. 需要在线应用时，使用侧栏底部的 在编辑区打开 或 在浏览器打开。

从可预览文件列表打开

GoMind 侧栏中的 可预览文件 会列出当前工作区中所有受支持的文件：

• 点击任意条目即可打开预览。
• 使用视图标题栏的刷新按钮重新扫描工作区。
• 使用列表/树形按钮在平铺列表和文件夹层级之间切换；选择会按工作区记住。
• 如果当前编辑器中的文件受支持，侧栏顶部还会显示当前文件的预览按钮。
• 列表会跳过常见的依赖和构建目录，例如 node_modules、.git、.svn、dist、build、out 和 coverage。工作区中受支持文件很多时，最多列出 1000 个。
• 工作区中没有受支持文件时，视图会显示提示。可以选择 选择文件进行预览，或从资源管理器打开文件。

阅读与导航

预览是只读的。可以使用画布本身提供的阅读控件和鼠标/触控板操作：

• 拖动空白区域平移画布。
• 使用滚轮、触控板或捏合手势缩放。
• 使用画布左下角的阅读控件聚焦根节点、切换分支、前进/后退、居中、查找、缩放、显示小地图以及显示或隐藏备注。
• 点击可见的分支控件折叠或展开内容，以便集中阅读当前部分。

不同版本和不同文件格式下，控件的名称或可用项可能略有差异，以界面实际显示为准。

刷新与编辑

• 预览读取磁盘上已经保存的文件内容；编辑器中尚未保存的修改不会立即显示。
• 默认情况下，保存源文件后预览会自动刷新。
• 当设置 gomind.viewer.enableAutoRefresh 为 true（默认值）时，保存源文件会重新加载预览。
• 关闭自动刷新后，保存不会更新预览。需要查看最新内容时，关闭当前预览标签页，再重新执行预览命令。
• 如果文件被 VS Code 之外的工具修改，也需要重新打开预览才能读取最新内容。
• 预览中不能编辑、保存、导出或同步文件。要修改内容，请回到源文件编辑器；XMind 和 GoMind 文件请使用 GoMind 应用编辑。

在线 Web 应用

GoMind 侧栏底部提供在线 Web 应用入口：

• 在编辑区打开：在 VS Code 标签页中加载在线 GoMind Web 应用，适合需要更宽画布的场景。
• 在浏览器打开：在默认浏览器中打开在线应用，适合登录、弹窗、剪贴板或兼容性要求较高的场景。

在线应用默认从 https://gomind.app/app/ 加载。需要中国大陆入口时，将设置 gomind.app.region 改为 mainland，插件会使用 https://gomindapp.com/app/。

在线应用与离线预览是两条独立路径：在线应用不会自动打开当前本地文件，插件也不会把本地文件路径、预览令牌或凭据传入在线应用。需要预览本地文件时，请使用前面的预览命令。

设置

在 VS Code 设置中搜索 GoMind 可以找到以下选项：

离线预览与隐私

• 插件自带 Viewer 渲染资源，离线预览不需要联网，也不会主动把文档上传到 GoMind 或其他远程服务。
• 首次打开预览时，插件会在本机 127.0.0.1 的随机端口启动本地 HTTP 服务，并通过短期随机令牌只暴露当前正在预览的文件。令牌约 30 分钟后失效；关闭预览标签页或切换到其他文件时，旧令牌会被释放。
• 本地服务只接受插件为当前文件生成的令牌，不能用来读取任意路径。
• 在线 Web 应用不同：它会联网加载 GoMind 的 Web 服务，适用相应的 Web 服务数据处理规则。插件不会把本地文件路径、预览令牌或凭据传入在线应用。
• 在共享电脑上，关闭预览标签页即可停止当前文件的令牌访问；长期不使用时可以禁用或卸载插件。

限制与边界

• 预览为只读，不能在预览中直接编辑、创建、保存、导出或同步文件。
• 插件不包含 GoMind 应用的云文档、版本历史、AI、账户和导入导出能力。
• 只支持上表中的扩展名。其他格式请先在 GoMind 应用中导入或转换。
• 插件不会接管 .gomind 和 .xmind 的默认打开方式。双击这些文件时 VS Code 可能显示二进制内容，请使用预览命令。
• 文件越大、结构越复杂，首次打开和保存后刷新所需的时间越长。
• 当前版本不适用于 vscode.dev、Remote SSH、Dev Containers 和 Codespaces 等远程或浏览器开发环境。

常见问题

右键菜单中没有预览命令

• 确认文件扩展名在上表范围内。
• 确认 GoMind Viewer 已安装并启用。
• 尝试从资源管理器右键，或在命令面板中搜索命令。
• 重新加载 VS Code 窗口。

预览空白或一直加载

• 先保存文件，再重新打开预览。
• 打开 视图 → 输出，选择 GoMind Viewer 或 GoMind Viewer Panel 查看错误信息。
• 确认安装的是完整扩展包，而不是只包含部分文件的副本。
• 尝试用较小的文件验证；如果只有某个文件失败，请记录文件格式和复现步骤。

保存后预览没有更新

• 确认 gomind.viewer.enableAutoRefresh 为 true。
• 关闭当前预览标签页，重新执行预览命令。
• 如果文件是在 VS Code 之外修改的，重新打开预览。
• 某些文件格式或大型文件可能需要更长时间完成解析。

可预览文件列表为空

• 确认已经打开工作区文件夹，而不只是打开单个文件。
• 使用视图标题栏的刷新按钮重新扫描。
• 确认文件没有被排除在常见构建/依赖目录中。
• 直接使用 选择文件进行预览 打开磁盘上的文件。

在线 Web 应用打不开

• 在线应用需要联网；确认网络、代理和防火墙允许访问 gomind.app 或 gomindapp.com。
• 在侧栏选择 在浏览器打开 作为备用入口。
• 如果浏览器可以打开而编辑区不能，优先使用浏览器版本完成登录或兼容性操作。
• 离线文件预览不依赖在线应用；即使在线入口不可用，本地预览仍可继续使用。

.gomind 或 .xmind 打开后显示乱码

这是二进制文件被 VS Code 默认编辑器当作文本打开的表现。请关闭该标签页，使用 使用 GoMind 预览 GoMind 或 使用 GoMind 预览 XMind 命令，或点击侧栏中的可预览文件条目。

需要反馈问题

报告问题时请提供：

• 扩展名称和版本；
• VS Code 版本和操作系统；
• 文件类型和复现步骤；
• GoMind Viewer 输出面板中的错误信息。

不要附上包含敏感信息的文档。

相关文档

• 导入与导出
• 云文档、AI 与集成
• 快捷键与故障排查

← 上一篇：云文档、AI 与集成 · 下一篇：快捷键与故障排查 →