QuickLook 使用教程：从安装到精通

QuickLook 模仿的是 macOS 的 Quick Look：在文件资源管理器里选中文件，按一下空格，预览窗口当场弹出，再按一下空格或 Esc 关掉。整个过程不需要打开对应软件，也不需要等应用启动。

听起来很简单，但真正用顺它需要跨过三个坎：装对版本、搞清预览窗口的焦点规则、知道不同文件在预览里能做什么。下面按顺序讲。

一、先装对版本：四个渠道的差别比你想的大

QuickLook 有四个官方来源，它们不是「同一个东西的不同下载地址」，功能上是有差异的。最常见的一个坑就是：为了省事从 Microsoft Store 装，结果发现在「打开/保存文件」对话框里按空格没反应。

官方的原话是：如果你不想研究这些，就直接装 .msi。它包含 QuickLook 的完整功能，也是我们推荐的默认选择。

什么时候该选别的

• 想让它自己升级：选 Microsoft Store 版。代价是上架节奏比其它渠道慢 1 到 3 个工作日，并且不能在打开/保存对话框里预览文件。
• 本来就是命令行用户：用 Scoop，两条命令搞定，升级也跟着 Scoop 走。
• 需要便携版：用 Installer 提供的便携包，配置和插件数据会写在程序目录下的 UserData 文件夹里，整个目录拷走就能用。
• 想提前试新功能：Nightly 构建，但官方明确说它可能不稳定，通常要过几周才会进稳定渠道。

安装完成后，QuickLook 会常驻系统托盘，并在你登录 Windows 时自动运行。你不需要每次手动启动它。

二、第一次按空格：先确认它真的在运行

很多人第一次用就卡在这里：装完了，选中文件按空格，什么都没发生。绝大多数情况下不是软件坏了，而是它没在跑，或者当前焦点不在文件资源管理器里。

1. 看托盘图标。任务栏右下角的托盘区域应该有一个 QuickLook 图标。没有的话，说明进程没运行，先从开始菜单启动它。

2. 点一下文件，让资源管理器拿到焦点。预览是跟着「文件资源管理器」走的：你得先单击选中一个文件，并且当前活动窗口是资源管理器本身。

3. 按空格。预览窗口出现。再按一次空格，或者按 Esc，窗口关闭。

如果托盘图标在、焦点也对，但空格就是没反应，那就属于故障范畴了，直接看 空格键没反应排查 那篇，里面按概率从高到低列了九种原因。

三、真正提效的一步：用方向键连续预览

只用空格，你得到的是「一次看一个文件」。真正让效率翻倍的是方向键——它让你能像翻相册一样连续扫过一整个文件夹。

做法是：选中第一个文件，按空格打开预览，然后直接按 ↑ ↓ 或 ← → 切换文件，预览内容会跟着换。整个过程中你的手不用离开键盘，鼠标也不用动。

看长文档时还能用 Page Up / Page Down 翻页，Home / End 直接跳到开头和结尾。挑照片、过素材、筛文档，这套操作比任何缩略图网格都快。

四、不同文件的预览里能做什么

预览窗口不只是「给你看一眼」，不同格式在里面的交互能力是不一样的。下面这些是日常最常用的：

图片：滚轮缩放

在图片预览里滚动鼠标滚轮就能放大缩小。想确认一张图有没有虚焦、构图对不对，比打开看图软件快得多。如果你发现图片颜色和原图有偏差，可以通过配置项调整色彩处理方式，详见下面的配置章节。

PDF：Ctrl 加滚轮缩放

PDF 预览支持滚动阅读和搜索，缩放要用 Ctrl 加滚轮。这里的 PDF 渲染依赖系统中的 WebView2 运行时——如果 PDF 打开是空白，问题通常就出在这一环，处理办法写在 故障排查 里。

视频与音频：直接播放

视频和音频在预览窗口里就能播，不需要启动播放器。如果遇到某些视频不出画面或者没声音，通常是解码器和显卡驱动的问题，官方给的解法同样在故障排查页。

压缩包：先看内容再决定解不解压

压缩包能直接在预览里列出内部文件清单。下载来的压缩包要不要解压、里面是不是你想要的东西，一眼就能判断。漫画包格式同样支持。

代码与文本：带语法高亮

各类源码、配置文件、日志、JSON 都会以带语法高亮的形式呈现，还能自动判断文件语言。开发时想看一个配置文件的内容，不需要再开编辑器。

Markdown：可以切换目录

Markdown 预览支持实时渲染，长文档还能呼出目录。默认的目录切换键是 Ctrl+Shift+L，这个键是可以改的——它是 QuickLook 里少数几个能自定义的按键之一。

3D 模型：左键旋转，中键平移

预览 3D 模型时，按住鼠标左键拖拽是旋转，按住中键拖拽是平移。做 3D 打印或者建模的人，用这个筛模型比开专业软件快太多。

两个容易被忽略的动作

• 按 Enter 用默认程序打开：看清楚了确实是你要的文件，回车直接打开，不用回去双击。
• 把文件从预览窗口拖出去：预览窗口里的文件可以直接拖拽——拖进聊天窗口发出去、拖进另一个程序当输入，都行。这是它比「另开一个窗口看」更顺手的地方。

五、快捷键速查

下表把默认按键列全了，建议先扫一遍，会用的不用背，用的时候回来看。

官方明确说了：目前不支持修改预览热键。也就是说空格是固定的，想让别的键触发预览得靠第三方工具。完整的按键说明与冲突处理，见 快捷键大全与热键修改。

六、让预览窗口更顺手：托盘菜单与配置文件

右键点击托盘里的 QuickLook 图标，就能打开设置和退出程序。但设置界面能调的东西有限，真正好用的选项都藏在配置文件里。

配置文件是 XML 格式，位置取决于你装的是哪个版本：

• MSI 安装版：%APPDATA%\pooi.moe\QuickLook\
• 便携版：程序目录下的 UserData\ 文件夹
• Microsoft Store 版：%LOCALAPPDATA%\Packages\21090PaddyXu.QuickLook_egxr34yet59cg\LocalCache\Roaming\pooi.moe\QuickLook\

主配置文件叫 QuickLook.config，插件各自有独立配置文件，命名规则就是插件名，例如 QuickLook.Plugin.ImageViewer.config。如果文件不存在，先运行一次 QuickLook，然后自己新建即可。

写进去的内容长这样：

<?xml version="1.0" encoding="utf-8"?>
<Settings>
  <Topmost>True</Topmost>
  <AutoReload>True</AutoReload>
</Settings>

几个值得一改的选项

图片预览还有两个和画质相关的开关：UseNativeProvider 默认开着，速度快但色彩略欠准，改成 False 会慢一点、颜色更准；UseColorProfile 打开后按显示器色彩配置做转换，做设计的人可能需要，代价是加载变慢。这两个选项在 QuickLook.Plugin.ImageViewer.config 里。

七、装插件解锁更多格式

内置支持已经覆盖了 100 多个格式，但遇到 CAD 图纸、APK 安装包、SQLite 数据库、电子书这些，还是得靠插件。插件的安装方式很简单，用一个空格键就能完成——下载 .qlplugin 文件，选中它按空格，在弹出的预览窗口里点 Install，然后重启 QuickLook。

哪些插件真的值得装、每个插件具体解决什么问题，单独写在了 插件安装与必装推荐 里，那里有完整清单和仓库地址。想先确认某个格式到底支不支持，翻 支持格式清单 更快。

八、常见问题