QuickLook 下载安装避坑指南

QuickLook 的安装本身并不复杂，但它提供的下载来源不止一个，而且这几个来源在功能上并不等价。选错渠道最常见的后果是：装完了能预览文件，却在「打开 / 保存文件」对话框里按空格一点反应都没有，于是以为软件坏了，反复重装也解决不了。另一类常见问题是下载了压缩包直接解压，程序一启动就崩溃。

这篇安装教程先给结论，再把四个渠道逐个拆开讲清差异，然后处理安装环节里真正的几个坑，最后给出一份装完之后的确认清单。无论你是在找 QuickLook 下载入口，还是想确认中文版下载渠道是否正规，答案都一样：以下列出的官方来源为准。

一、先给结论：不确定就装 .msi

官方对这件事的表态非常直接：如果你不想研究这些渠道差异，就直接装 .msi 安装包。它包含 QuickLook 的完整功能，也是官方推荐的默认选择。记住这一句，后面的内容你可以在需要的时候再回头查。

如果你已经确定要继续往下看，那就按「你更在意什么」来选：在意省心就选自动更新的渠道，在意功能完整就选安装包，是命令行用户就用包管理器，只是想尝鲜再考虑夜间构建。

二、四个渠道逐个说清楚

四个渠道分别面向不同的人。下面按「谁适合选它」的顺序讲，每个渠道都把它缺什么讲明白。

Microsoft Store

从 Microsoft Store 安装最大的好处是自动更新，你完全不用管版本这件事。代价有两点：一是不支持在打开 / 保存对话框里预览文件，只能预览文件资源管理器里的内容，这个限制在很多时候相当难受；二是上架节奏比其它渠道慢 1 到 3 个工作日，上游发了新版本，你要多等几天。

Store 的入口是 Microsoft Store 页面。如果你平时只预览资源管理器里的文件，又希望装完就再也不用管，选它没问题。

Installer（.msi）

功能最全的一个渠道：支持打开 / 保存对话框预览，也支持便携模式。便携版的配置和插件数据会写在程序目录下的 UserData 文件夹里，整个目录拷到 U 盘或另一台机器上就能直接用，这一点对需要在多台机器之间搬环境的人很有价值。

安装包和夜间构建都发布在上游的 GitHub Releases 页面。不想研究渠道差异的话，就是它。

Scoop

如果你本来就是命令行用户，Scoop 是最省事的一条路，两条命令：

scoop bucket add extras
scoop install quicklook

之后升级也跟着 Scoop 走，一条 scoop update 就能覆盖。需要注意：Scoop 版不支持便携模式，如果你的诉求是「整个目录拷走就能用」，那就得回到 .msi。

Nightly（夜间构建）

Nightly 是实验性构建，用途是提前试还没有进稳定版的新功能。官方的说法是它可能不稳定，并且通常要过几周才会进入稳定渠道。日常使用不建议选它，除非你明确想尝鲜，并且接受它某天突然出问题。

三、四个渠道的差异对照表

把上面的差异放进一张表里，选择会变得很直观：

几个渠道共享的部分是：都支持 Windows 10 / Windows 11，都可以在文件资源管理器里按空格预览。真正的差别集中在上面这四行里——尤其「打开 / 保存对话框预览」和「便携模式」这两项，装完之后再后悔就得重装一次。

四、安装环节最容易踩的三个坑

下面三个问题占了安装类反馈的绝大多数，每一个都可以在动手之前避开。

解压包必须先「解除锁定」

正确顺序不要颠倒：先右键压缩包 → 打开「属性」→ 在底部勾选「解除锁定」→ 确定，然后才是解压。已经解压过、并且程序一开就崩的，重新把压缩包解一次锁、再覆盖解压一遍即可。

解压包通常就是便携版，数据放在 UserData

会去下 .zip / .7z 的人，大多是想用便携版。判断便携版的方式是看数据位置：v3.6.10 起的便携版会把配置与插件数据写在程序目录下的 UserData 子文件夹里；更早的版本仍然写在 %APPDATA% 下。

所以在把整个目录拷到别处之前，先确认里面有没有 UserData——如果没有，说明这一份的配置并不跟着目录走，插件也需要重新装。

.exe 安装器可以自选目录，但需要管理员权限

如果你下载的是 .exe 安装器，安装过程中可以自己指定安装目录，例如 C:\Program Files\QuickLook。但这一步需要管理员权限，权限不足时安装会中止。遇到这种情况，直接用 .msi 安装（会装到系统默认位置）通常更省事。

另外补充一句：官方只提到 .msi 版也可以通过 Chocolatey 获得，并没有在文档里给出具体命令。如果你打算走这条路，请以 Chocolatey 官方页面上的说明为准，不要照抄来路不明的命令。

五、装完后必须确认的三件事

安装完成之后别急着用，先按下面三步确认一遍。这三步能提前把后面「以为坏了」的误判挡掉。

1. 托盘图标在不在。任务栏右下角的托盘区域应该有一个 QuickLook 图标，说明进程已经在运行。安装后它会常驻托盘，并随你登录 Windows 自动启动（官方 README 的原话是 It runs automatically），不需要每次手动打开。

2. 选中文件按空格有没有反应。打开文件资源管理器，单击选中一个文件，按 Space。前提是当前活动窗口确实是资源管理器，而不是别的程序。完全没有反应的话，先看 空格键没反应排查，里面按概率列了九个原因。

3. 打开 / 保存对话框里能不能预览。在任意程序里点「打开文件」，在弹出的对话框里选中一个文件按空格。这一步能直接验证你装的是不是 Store 版——Store 版在这里不会有任何反应，其余三个渠道都支持。如果你需要这个能力却没反应，说明装错了渠道。

六、系统要求

QuickLook 的系统要求不复杂，但有几项是硬条件，装之前先对一下：

• 操作系统：Windows 10 或 Windows 11。官方支持范围就是这两个，不在这个范围内的系统不要指望能正常跑。
• 系统架构：x64。
• 运行时依赖：依赖 .NET Desktop Runtime。安装包通常会自动处理这一步，一般不需要你手动安装。

装好之后，它可以在文件资源管理器里工作，也支持打开 / 保存对话框内的文件预览（Store 版除外），对 Total Commander、xplorer²、OneDrive、Dropbox 这类第三方文件管理器与云盘目录同样适用。

七、常见问题