QuickLook 插件安装：三步装好，附 10 个必装推荐

QuickLook 内置的支持面已经覆盖了 100 多个格式，日常的图片、文本、压缩包、音视频基本不用额外装东西。但总有一些格式落在这之外：CAD 工程图、APK 安装包、SQLite 数据库、电子书，这些就得靠插件补上。

很多人第一次接触插件会被「qlplugin」这个文件后缀卡住——它双击没用，拖进程序里也没反应。原因很简单：QuickLook 的插件安装是用空格键触发的，跟你平时预览文件是同一个动作。理解这一点，后面就顺了。

一、插件能解决什么

插件解决的问题可以归成两类：让原本预览不了的格式能预览，以及把能预览的格式做得更好用。前者比如 CAD 图纸、APK、种子文件，不装插件就是一按空格没反应；后者比如 PDF、Office 文档，装对了插件能让阅读体验明显不同。

插件也就是 QuickLook 扩展机制。它和程序本体是分开的：本体负责「按空格弹窗」这件事，具体某个格式怎么渲染、能显示哪些信息，交给对应的插件。所以你会看到同一个格式在不同插件下表现不一样，也正是这个原因。

要不要装插件、装哪些，取决于你平时会碰到什么文件。下面先讲怎么装，第五节再给一份可以直接照着装的清单。

二、安装流程：三步，一个空格键

QuickLook 的插件安装方式很特别，它不通过应用商店，也不用命令行。整个过程只有三步，核心那一步就是按一次空格。

1. 下载插件文件。插件以 .qlplugin 结尾，从对应插件的仓库发布页把文件下载下来即可，不需要解压。

2. 确保 QuickLook 正在运行，然后选中这个 .qlplugin 文件按空格。注意两个前提：QuickLook 必须在跑，不然预览窗口根本出现不了；操作对象是这个文件本身，不是去双击它。

3. 在预览窗口里点 Install 按钮，然后重启 QuickLook。安装动作发生在预览窗口里——预览 .qlplugin 时，窗口上会出现安装入口，点下去，再重启 QuickLook 让插件生效。

这三步记牢，之后装任何插件都是同一套动作。所谓「qlplugin 怎么装」，答案就是这么直接：选中它，按空格，点 Install，重启。

三、升级：和安装是同一套动作

插件升级不需要先卸载。做法和安装完全一样：下载新版 .qlplugin，确保 QuickLook 正在运行，选中新文件按空格，点 Install，再重启 QuickLook。官方给出的升级流程就是「重复安装的那套步骤」，不用去插件目录里手工替换文件。

所以遇到插件出新版本，最省事的路径就是：把它当成一次新的安装来做。先卸载再装反而多此一举，也容易把插件的配置一起删掉。

四、卸载与插件目录在哪

卸载三步

1. 退出 QuickLook。先让进程停下来，再去动它的文件，避免占用冲突。

2. 进入数据位置，也就是插件目录所在的地方。

3. 删除这个插件对应的文件夹。插件在磁盘上各自占一个文件夹，删掉它，插件就等于卸载了。

插件目录的位置取决于安装方式

插件目录就在 QuickLook 的用户数据位置下面，而数据位置按发行版不同：

• MSI 安装版：%APPDATA%\pooi.moe\QuickLook\
• 便携版（v3.6.10 起）：程序目录下的 UserData\ 子文件夹
• 便携版（v3.6.9 及以前）：%APPDATA%\pooi.moe\QuickLook\
• Microsoft Store 版：%LOCALAPPDATA%\Packages\21090PaddyXu.QuickLook_egxr34yet59cg\LocalCache\Roaming\pooi.moe\QuickLook\

备用安装方式：手动解压

如果按空格那套流程走不通——比如 .qlplugin 文件本身预览不出安装入口——还有一条免预览的路：把 .qlplugin 当成普通压缩包解压，放进 QuickLook 安装目录下的 QuickLook.Plugin 文件夹里。这是官方给出的备用方式，效果一样，只是少了预览窗口那一步确认。

五、10 个必装插件清单

下面这 10 个是从官方插件清单里挑出来的、中文用户最常碰到的场景，覆盖 Office、PDF、电子书、APK、CAD 图纸、数据库、文件夹、Notebook、种子文件和光盘镜像。也可以把它当成一份按场景排好的插件推荐：缺什么补什么，不用逐个试。每条都给出用途、支持的格式与仓库地址，链接直接指向插件仓库，点进去在 Releases 里就能找到 .qlplugin 文件。

其中四个使用频率最高，单独展开说一下。

OfficeViewer：不装 Office 也能看 Office 文档

它的定位很明确：无需安装 MS Office 即可预览 Office 文档，覆盖 Word、Excel、PPT 等。也就是说，在一台没有装 Office 的机器上，你照样能按空格看一眼文档内容，不用为此装一套完整的办公软件。

PdfViewer-Native：让 PDF 预览真正好用

它提供基于 WebView2 的 PDF 预览，滚动流畅、支持搜索。如果你遇到 PDF 打开是空白的情况，问题可能就出在这个插件与 WebView2 运行时上，具体排查见 故障排查 那一篇的 PDF 一节。

SumatraPDFReader：一次补齐电子书格式

基于 SumatraPDF，它一次覆盖 .epub、.mobi、.cbz、.cbr、.fb2、.chm、.xps、.djvu 一大票格式。看电子书、看漫画包、看帮助文档，装这一个基本就够了，不必为每种格式单独找插件。

ApkViewer：不装模拟器就能看安装包

不装模拟器就能看 APK 的包名、权限、图标。下载了一个安卓安装包想确认它到底是什么应用、要什么权限，按一下空格就够了，比装个安卓环境轻太多。

六、三个有坑的插件，装之前先看

官方插件清单里明确标注了三个需要留意的插件，别看到名字就直接装：

• EpubViewer：2018 年之后就没有再维护，建议直接改用 SumatraPDFReader，后者覆盖的电子书格式更全。
• FontViewer：与 QuickLook 3.7 不兼容。装了在当前版本上跑不起来，属于版本不匹配的问题。
• OfficeViewer-Native：需要本机已经装好 MS Office 或 WPS 才能用，官方对它的标注是「使用风险自负」。想预览 Office 文档，优先选上面清单里的 OfficeViewer。

七、常见问题