预览出问题的时候，多数人的第一反应是「重装一遍」。但 QuickLook 的预览链路分了好几层——程序本身、.NET 运行时、每个格式各自的插件、以及插件依赖的渲染引擎。重装只能修最外面那一层，装错方向往往白忙一场。
所以这篇不按「问题列表」排，而是先教你判断故障落在哪一层，再按类型一条条往下查。下面出现的每一个配置项和插件，都来自官方文档与 Wiki 的已核实内容。
一、先判断：是「预览空白」还是「程序没启动」
预览异常表面上都是「什么都看不到」，但起点完全不同。动手之前先做一个判断：QuickLook 本身还在不在运行。
- 程序根本没启动：托盘区域看不到 QuickLook 图标，选中文件按空格毫无反应，预览窗口的边框也不闪一下。这类问题的关键词是「无法启动」，直接跳到第四节。
- 程序在跑，但某类文件预览是空白：托盘图标正常，图片和文本都能预览，偏偏 PDF 或 Office 文档不行。这说明程序是活的，问题出在对应格式的渲染环节，第二、三节处理的就是这一类。
分清楚这一点能省掉大量无效操作。把「缺插件」当成「软件坏了」去反复重装，是这条排查路上最常见、也最浪费时间的错误。
先换一个同类型的文件试。如果换文件还是空白，问题在渲染链路，也就是插件或运行时；如果只有某一个文件不行，那多半和这个文件自身有关——例如文件路径或文件名里的特殊字符，见第八节。
二、PDF 打开空白或显示异常
PDF 是反馈最多的一类。它在 QuickLook 里的渲染由 PdfViewer-Native 插件负责，而这个插件又基于系统中的 WebView2 运行时。所以「PDF 空白」通常只在两个层面出问题：插件没到位，或者运行时没到位。
根因一：系统缺少 WebView2 运行时
PdfViewer-Native 把渲染工作交给 WebView2 完成。如果系统里没有这套运行时，插件拿不到渲染引擎，预览出来就是一整页空白。要特别留意的是：装了插件并不等于装了运行时，这是两件分开的事。排查时先确认系统里存在 WebView2 运行时。
根因二：其实并没有装 PDF 插件
另一种情况更常见也更简单：压根没装 PdfViewer-Native。QuickLook 的内置能力覆盖了很多格式，但 PDF 的这套原生渲染来自插件。插件去哪里下载、怎么用空格键装上去，完整流程写在 插件安装与必装推荐 里。
PDF 打开空白、PDF 乱码，是这一类问题的两种典型表现。空白几乎总是指向渲染引擎没跑起来，也就是插件或 WebView2 运行时的问题。乱码的表现虽然不同，但排查的第一段路径一样——仍然先确认 PdfViewer-Native 与 WebView2 运行时是否就位，再考虑文档本身。
三、Office 文档预览不出内容
Word、Excel、PPT 这类 Office 文档在 QuickLook 里有两条插件路线，选哪一条，决定了「要不要本机装 Office」。选错了路线，就会出现 Office 空白——明明装了 Office，预览还是不出内容的困惑。
OfficeViewer：不依赖本机 Office
OfficeViewer 的设计目标就是无需安装 MS Office 即可预览 Office 文档。如果你的机器上本来就没有 Word、Excel 或 PowerPoint，装这个插件就能直接预览。它的配置里有一个 AlwaysUnblockProtectedView 开关，和文档的受保护视图拦截有关，Office 文档被挡下时值得留意这一项。
OfficeViewer-Native：需要本机已装 Office，官方标注「使用风险自负」
另一条路线是 OfficeViewer-Native。它自己不带渲染能力，而是依赖你本机已经装好的 MS Office 或 WPS——本质上只是调用你机器上已有的 Office。官方对这个插件的标注是「使用风险自负」，所以除非有明确理由，否则优先选 OfficeViewer。
四、无法启动或一打开就闪退
这一类是「程序根本没站起来」，和预览空白完全是两码事。按概率从高到低，先查下面两条。
第一条：.NET Desktop Runtime 是不是缺了
QuickLook 依赖 .NET Desktop Runtime。正规安装包通常会自动把它一起处理好，但如果安装过程被中断，或者你是手动解压后直接运行，运行时可能并没有装上。运行时缺失时，程序在启动阶段就会失败，表现就是托盘图标一直不出现，或者刚起来就退掉。
第二条：解压包没有「解除锁定」
如果你下载的是 .zip 或 .7z 压缩包，处理顺序很关键：必须在解压前，先在文件属性里点「解除锁定」。从网络下载的压缩包会被 Windows 打上「来自其他计算机」的标记，跳过这一步直接解压运行，QuickLook 会崩溃——这是官方专门说明过的已知问题。
遇到解压版启动即崩溃，第一件事不是重装，而是回到那个压缩包，右键打开属性，看看底部有没有「解除锁定」的勾选框。先解锁、再解压、再运行，这个顺序不能颠倒。
五、视频音频没有画面或没有声音
视频不出画面、音频没声音，官方在常见问题页里给出了三条经过用户验证的解法，建议按顺序试：
-
安装 K-Lite Codec 解码包。视频解码依赖系统里已有的解码器，缺了就会出现「有声音没画面」，或者干脆播不动的情况。
-
更新显卡驱动。解码和渲染都要吃显卡。如果显卡型号较老、驱动长期没有更新，官方还提到可能需要手动降级 LAVFilters 版本才能恢复正常。
-
在设置里选择 QuickLook 使用的 GPU。核显加独显的多显卡机器上，指定它用哪一块 GPU，有时就能绕开出问题的那一块。
此外，视频插件自己的配置里还有几个播放相关的开关：UseHardwareAcceleration（尝试硬件加速，依赖系统与已装滤镜）、ShouldLoop（是否循环）、VolumeDouble（音量，取值 0.0 到 1.0），都在 QuickLook.Plugin.VideoViewer.config 里，可以按需调整。
六、图片颜色不对、预览卡顿
这两类问题都出在渲染这一层，但处理方向恰好相反：卡顿要「往回退」，颜色要「往前调」。方向搞反，怎么改都不对。
卡顿、花屏、闪退：把 ProcessRenderMode 设为 1
在 QuickLook.config 里，ProcessRenderMode 默认是 0，表示走默认渲染。把它改成 1 会强制走纯软件渲染。显卡驱动有问题导致花屏、闪退时，改这一项是最直接的验证手段：如果改完就恢复正常，基本可以确定问题出在显卡驱动或 GPU 本身，再回头去更新驱动。注意这是排查用的手段，不是长期方案。
颜色不准：UseNativeProvider 与 UseColorProfile
图片预览有两个和画质相关的开关，都在 QuickLook.Plugin.ImageViewer.config 里。UseNativeProvider 默认开着，速度快但色彩略欠准，改成 False 会慢一点、但颜色更准；UseColorProfile 打开后会按显示器的色彩配置文件做转换，对做设计的人有意义，代价同样是加载变慢。
卡顿是性能问题，优先动 ProcessRenderMode；颜色是准确度问题，优先动图片插件的那两个开关。为了色彩去改渲染模式，或者为了流畅去调色彩转换，往往都改不出想要的结果。
七、预览窗口「自己关掉」
如果你觉得预览窗口会无端消失，先别怀疑程序不稳定，多半是下面两个配置项在起作用，它们都在 QuickLook.config 里。
- AutoCloseHolding：默认 True。含义是长按空格超过 750 毫秒之后再松开，预览就会自动关闭。很多人按空格时手指停留稍长，一松手窗口就没了，于是误以为它自己消失。嫌它碍事就改成 False。
- CloseOnLostFocus：默认 False。如果它被改成了 True，那么预览窗口一旦失去焦点就会关闭——你点一下别处它就没了。想让窗口留着，确认这一项是 False。
八、官方标注的两个已知问题
官方常见问题页里明确列出了两个和「字符」有关的已知问题。遇到「明明格式支持却打不开」的情况时，值得对照一下。
路径含非法字符导致视频不工作
如果视频文件所在的路径里含有非法字符，视频预览可能不工作，这个问题在上游有对应的记录（issue #1197）。遇到「同类型视频有的能播、有的不能播」，可以留意一下文件所在的路径本身。
文件名含特殊字符报「系统找不到指定的文件」
当文件名里带有特殊字符时，可能出现「系统找不到指定的文件」这样的错误提示（上游 issue #1067）。这种情况下文件其实就在原地，是名字里的字符让程序处理不了。把文件名改成干净的普通字符再试，通常就能恢复。
九、拿不准时，去看崩溃详情与异常日志
上面几节都试过还是没有头绪，就别再凭感觉猜了。官方专门提供了查看崩溃详情与异常日志的途径，相关内容在官方 wiki 上有独立页面。遇到程序崩溃、闪退这类问题，与其反复重装，不如先把它的崩溃信息取出来，再对照着处理。
需要说明的是，本节不提供具体的菜单路径或操作步骤——这一部分以官方 wiki 的说明为准，页面内容随时可能更新，照着这里的描述去 wiki 查询才是最稳妥的做法。
「什么文件格式 + 用了哪个插件 + 具体表现（空白 / 闪退 / 无声音）」这三样写清楚，比只截一张黑屏截图有用得多，也更容易在 wiki 或上游 issue 里搜到同类情况。
十、常见问题
PDF 打开是空白页，是文件坏了还是软件问题？
多数不是文件问题。PDF 预览由 PdfViewer-Native 插件负责，它依赖系统里的 WebView2 运行时。先确认这个插件已经装上，再确认 WebView2 运行时是否齐全；这两步都正常，才去怀疑文件本身。
明明装了 Office，为什么 Word 文档预览还是空白？
因为预览走的是插件，而不是你本机装的 Office。装 OfficeViewer 插件，就能在不需要本机 Office 的情况下预览 Office 文档。如果你的机器上确实装了 MS Office 或 WPS，也可以改用 OfficeViewer-Native，但要记住官方对它的标注是「使用风险自负」。
QuickLook 双击打不开，或者一闪就没，最可能是什么原因？
两种最常见。一是系统缺 .NET Desktop Runtime，QuickLook 依赖它，安装包通常会自动处理，但被跳过或安装失败时就起不来。二是你下载的是 .zip 或 .7z 解压版，解压前没有先在文件属性里点「解除锁定」，这种状态下 QuickLook 会直接崩溃。
视频能播放但没有声音，或者干脆没有画面，怎么办？
官方给了三条用户验证过的解法：安装 K-Lite Codec 解码包；更新显卡驱动，显卡太老且驱动长期不更新的用户可能还需要手动降级 LAVFilters 版本；在设置里选择 QuickLook 使用的 GPU。
预览图片时颜色和原图对不上，怎么调？
这是图片插件的色彩处理选项。把 UseNativeProvider 改成 False，色彩会更准，代价是加载变慢；再打开 UseColorProfile，让它按显示器的色彩配置文件做转换。这两个选项都在 QuickLook.Plugin.ImageViewer.config 里。
预览卡顿、花屏甚至闪退，是不是显卡驱动的问题？
有这个可能。可以在 QuickLook.config 里把 ProcessRenderMode 改成 1，强制走纯软件渲染，用来验证是不是显卡驱动引起的；如果改完就正常，说明问题在驱动或 GPU，再考虑更新驱动。反过来，如果只是色彩不准，优先动图片插件的那两个选项，不要一上来就切软件渲染。
预览窗口经常自己关掉，能改成不自动关吗？
先看 AutoCloseHolding，它默认是 True，含义是长按空格超过 750 毫秒后松开就关闭预览，很多人会误以为是无端消失，改成 False 即可。CloseOnLostFocus 默认是 False，如果它被改成了 True，一点别处预览也会关，确认它是 False。两个配置项都在 QuickLook.config 里。