File Explorer zh

文件浏览器与预览

English · 中文

在侧边面板浏览本地、WSL 与 SSH 文件，并在不离开终端的情况下预览 Markdown、文本、表格、图片和 PDF。

打开文件浏览器

按 Ctrl+Shift+Alt+E 打开左侧文件浏览器。它跟随当前活动环境：

• Windows shell 浏览本地 Windows 路径。
• WSL 会话通过 wsl.exe 浏览默认 WSL 发行版。
• WispTerm SSH profile 会话通过 OpenSSH 辅助命令浏览远程主机。

预览文件

用以下两种方式之一在右侧打开预览面板：

• 按住 Ctrl（macOS 上 Cmd）并点击终端输出中的 .md、.txt、.csv、.tsv、 源代码或脚本文件（含 R 脚本 .r / .R）、受支持的图片文件或 .pdf，或
• 在文件浏览器里双击受支持的文件。

每种内容类型（Markdown、纯文本、CSV/TSV、图片）各有自己的预览面板：再次预览同 类型文件会替换该面板的内容；预览不同类型的文件则会在现有预览下方堆叠出一个新 面板——Markdown、图片和 CSV 表格可以同时留在屏幕上。

各类型的渲染：

• Markdown —— 标题、列表、引用块、代码块、行内代码、链接和分隔线。
• 文本 / 代码 / 脚本 —— 以纯文本显示（.r、.R、.py、.zig、.sh、.json 等）。
• CSV / TSV —— 以网格表格显示。
• 图片 —— PNG、JPEG、GIF、BMP、WebP 直接解码到面板中。
• PDF —— 由操作系统自带的 PDF 引擎逐页光栅化：Windows 10+ 上是 Windows.Data.Pdf，macOS 上是 CoreGraphics，Linux 上是 poppler-utils 工具（pdfinfo / pdftoppm，若预览提示缺失，可用如 sudo apt install poppler-utils 安装）。PDF 预览面板聚焦时，PageUp / PageDown 翻页，底部状态栏在 PDF 徽标旁以 N/M 显示当前页码。不支持 加密的 PDF。

终端路径识别

路径点击来自终端输出，不只来自文件浏览器。WispTerm 会把软换行路径拼回一起，跟随跨终端 行的路径续接，并能从附近的 ls src/input 这类命令推断目录前缀。也就是说，当 ls <dir> 列出的裸文件名能明确匹配目录前缀时，它可以按 <dir>/<file> 预览。

用默认应用打开文件

按住 Ctrl（macOS 上 Cmd）并右键点击本地终端中的文件路径，即可用操作系统为 该文件类型注册的默认应用打开它（Linux 上 xdg-open，macOS 上 open，Windows 上系统 注册的处理程序）。

此功能仅适用于本地终端 —— 本地应用无法打开 SSH 与 WSL 路径，因此在那些会话中 Ctrl+右键会回退到配置的 right-click-action（复制/粘贴），见 配置。 不按 Ctrl 的普通右键始终执行配置的 right-click-action。

调整大小、滚动与缩放

• 拖动浏览器与预览面板的内侧边缘可调整大小。
• Markdown、文本、CSV、TSV 预览支持鼠标滚轮滚动；CSV/TSV 单元格内容放不下时，悬停会 显示更大的弹窗。
• 图片与 PDF 预览支持滚轮缩放，放大后可拖动平移。
• Ctrl+Shift+W 关闭当前选中的面板——点击预览面板（或按 Ctrl+1-9）选中它， 即可像普通分屏一样关闭。

下载远程文件

在 SSH profile 会话中，按住 Ctrl+Shift（macOS 上 Cmd+Shift）悬停在终端输出里的 文件路径上使其加下划线，然后点击即可把该远程文件下载到 %USERPROFILE%\Downloads。 下载在后台进行。

SSH 元数据要求

远程预览与下载需要 WispTerm 的 SSH profile 元数据，因此仅支持从内置 SSH 启动器发起的 会话。在本地 shell 里手动敲 ssh user@host 仍被当作那个本地 shell，无法使用远程文件 预览 —— 见 SSH 与远程开发。

---

另见：SSH 与远程开发 · 浏览器与 Jupyter 面板