Folia Files
购买 下载

所有文章

如何在 Mac 上用快速查看预览代码、Markdown 和 ZIP

· 阅读约 6 分钟

在访达中选中一个 Swift 或 Python 文件，按下空格键：快速查看会把代码显示成纯文本，通篇一个颜色。README.md 显示的是 # 和 **，而不是标题和粗体。ZIP 文件则只显示图标、名称和大小，里面的文件一个也看不到。

快速查看只能显示 Mac 上已安装的预览能绘制的内容。macOS 自带的预览把代码、JSON 和 Markdown 都当作纯文本处理，也没有一个能读取归档。从 macOS Sequoia 开始，过去用来填补这个空缺的旧插件不再加载：更好的预览如今来自 App 安装的快速查看扩展。Folia Files 就带有这样一个扩展。有了它，在访达和“邮件”中按空格键，代码会带语法高亮和行号显示，JSON 会缩进排版，Markdown 会渲染，ZIP 或 TAR 归档会列出其中的文件。

快速查看本身能显示什么

只靠 macOS，在文件上按空格键（或 ⌘Y）会得到：

  • 源代码（Swift、Python、JavaScript、Shell 脚本等）：纯文本，没有颜色，也没有行号。
  • JSON：同样是纯文本，没有颜色。
  • Markdown：原始文本，所有 #、* 和 [链接](…) 都原样可见。
  • ZIP 和 TAR 归档：只有归档的图标、名称和大小，看不到其中的内容。

CSV 文件是例外：macOS 已经能把它显示成表格。

原因：插件已被淘汰，扩展接替了它们

快速查看根据文件类型来选择预览。macOS 自带文本、图像、PDF、音频和视频、Office 和 iWork 文稿等几类预览。在 macOS 看来，源代码、JSON 和 Markdown 都属于文本，所以都只得到纯文本预览；系统自带的预览也没有一个能读取归档里的内容。

多年来，只要把 .qlgenerator 插件放进资源库的 QuickLook 文件夹，就能增加新的预览。macOS Sequoia（15）不再加载这些插件，用这种方式安装的预览随之失效。现在，新的预览必须是 App 内附带的快速查看扩展：安装 App 后，macOS 就会使用它的扩展。

有两个地方可以看清楚情况：

  • 系统设置 › 通用 › 登录项与扩展：在“扩展”部分，“快速查看”列出了各个 App 安装的预览扩展，并可以逐个关闭。
  • 终端：qlmanage -p ~/Desktop/README.md 会像访达那样打开某个文件的预览；qlmanage -m plugins 列出 macOS 自带的预览以及每个预览负责的文件类型（App 的扩展不会出现在这里）。

Folia Files 的快速查看扩展

Folia Files 是一款 Mac 文件管理器，附带一个快速查看扩展。无需另外安装任何东西：只要 App 放在“应用程序”文件夹中并打开过一次，凡是 macOS 显示快速查看预览的地方，空格键都会使用这个扩展，包括访达和桌面、“邮件”中的附件，以及其他 App。

下面的截图拍摄于 Folia Files 内部的“预览”模块；在访达中，这个扩展会以同样的方式为同一个文件着色，并在页边额外显示行号。

Folia Files 以列表显示一个项目的 Swift 源文件，右侧面板中的“预览”模块以语法高亮显示 AtlasApp.swift

能预览哪些文件

  • 代码：Swift、Python、JavaScript、Ruby、PHP、Perl、Shell 脚本、C 和 C++、Objective-C、Java、SQL、CSS、YAML，以及其他被 macOS 识别为源代码的语言。关键字、字符串、数字、注释和类型名各有颜色，页边显示行号，并跟随 Mac 使用浅色或深色外观。只显示文件的前 600 KB。
  • JSON：缩进并着色，键按字母顺序排列，因此顺序可能与文件中不同。不是有效 JSON 的文件会按原样显示。
  • Markdown：渲染后显示，包括标题、粗体和斜体、项目符号列表、编号列表和任务列表、引用、表格、代码块和链接。
  • ZIP 和 TAR 归档，无论是否经过 gzip 压缩（.tar.gz、.tgz）：先显示文件数量和解压后的总大小，再以缩进方式列出每个文件夹和文件，并标出每个文件的大小（最多显示前 5,000 项）。

对于 7z、RAR 等其他归档格式以及 CSV 文件，macOS 仍使用自己的预览。

有几种文件不在它的范围内，因为 macOS 不把它们看作代码。TypeScript 的扩展名 .ts 同时也是 MPEG 传输流视频的扩展名，所以 macOS 会把这类文件当作视频。Go 或 Rust 文件往往没有 macOS 能识别的类型，除非有其他 App 声明了一个。对于这些文件，访达仍显示平常的预览。

关闭扩展，或在两个 App 之间选择

在“系统设置 › 通用 › 登录项与扩展”中，这个扩展以“Folia Files”的名称显示在“快速查看”下。关闭它，macOS 就会恢复使用自己的预览。

如果 Mac 上另一个 App 也有用于 Markdown 或代码的快速查看扩展，访达对同一个文件只会显示其中一个预览。想用另一个，就在同一列表中关闭你不需要的那个扩展。

网站版和 Mac App Store 版的 Folia Files 都包含这个扩展。

在 Folia Files 中：同样的预览，空间更大

在 Folia Files 中，对代码、Markdown、JSON、CSV 和归档按空格键，会打开 App 自己的预览窗口；照片、PDF、视频和其他文稿照常交给快速查看。这个窗口浮在面板之上：用方向键继续浏览文件，预览会随之更新，再按空格键即可关闭。对应的设置是“设置 › 文件与网络 › 预览与归档”中的“Folia Files 预览，适用于代码、Markdown、JSON、CSV 和归档（空格键）”。

如果想在工作时一直在文件旁边看到预览，可以使用 Folia Files 的模块之一：“预览”模块。用右侧边栏的“模块”按钮把它添加到右侧边栏，或者把工具栏中的“新面板”拖到窗口边缘，然后在出现的网格中选择“预览”。它会显示你在当前面板中选中的内容。

顶部的按钮用来切换显示方式：Markdown 有“渲染”“源”和“十六进制”，JSON 有“已格式化”，CSV 有“表格”，归档有“内容”。着色和 Markdown 渲染与扩展中完全相同。

Folia Files 的“预览”模块在“渲染”“源”“十六进制”按钮下方显示渲染后的 Notes.md，包括一个标题和一个项目符号列表

归档还多一种用法：在 Folia Files 的面板中双击 ZIP 文件，它会像文件夹一样以只读方式打开，你只需复制出需要的文件。如何在 Mac 上不解压就打开 ZIP 文件介绍了具体做法。

小结

  • 在访达和“邮件”中看到着色的代码、缩进的 JSON、渲染的 Markdown 和归档内容：安装 Folia Files 并打开一次，剩下的交给空格键。
  • 恢复 macOS 自带的预览：在“系统设置 › 通用 › 登录项与扩展”的“快速查看”中关闭 Folia Files。
  • 在文件旁边一直开着的预览：使用 Folia Files 的“预览”模块，放在右侧边栏或单独的面板中。