1. 先分清故障现象：缩略图消失不是只有一种“坏法”
访达缩略图显示异常，可以说是Mac用户绕不开的一个老问题。我见过太多人一遇到缩略图空白就直接重装系统，结果重装完没两天又犯了，问题压根没解决。说白了，你得先搞清楚自己遇到的是哪一种“不显示”，因为不同表现背后的原因和修复路径完全不同。
这个问题在macOS的各个版本里都很常见，无论是Intel芯片的老Mac，还是M系列芯片的新机器，都有人踩坑。从我的实际经验来看，大概可以分成四种典型表现：
| 表现 | 具体现象 | 最可能的根因方向 |
|---|---|---|
| 第一种 | 访达里图片、视频全部变成空白格，没有缩略图 | 缩略图缓存数据库损坏或权限异常 |
| 第二种 | 图标正常，但鼠标悬停、点击空格键预览时黑屏或转圈 | Quick Look进程卡死或插件冲突 |
| 第三种 | 部分文件类型有缩略图，另一部分死活不显示 | Quick Look插件缺失或对应解码组件损坏 |
| 第四种 | 缩略图能显示，但全是“紫色问号”或通用图标 | 文件关联被改动，或文件本身有隔离属性 |
你可能会问：前三种我还能理解，“紫色问号”是什么情况？这个其实也很典型。它意味着系统已经识别到这个文件了，但不知道用什么应用去打开它。有些时候你双击还能正常打开，但访达就是不生成缩略图——这通常不是缓存问题，而是文件类型关联出了问题。
我遇到过不少用户向我描述问题的时候，只说一句“我的访达不显示预览了”，但仔细追问下来，每个人的表现都不一样。这就是为什么我写这篇东西的时候，特意把现象分类放在最前面：不先搞清楚自己面对是哪种情况，上来就按网上的教程一顿操作，很容易越修越乱。
顺便提一句，有朋友跟我说Windows上也有类似的毛病，比如Win10图片编辑器无法预览、Win11资源管理器预览窗格不显示之类。确实，这两个系统在缩略图机制上有相似之处，但macOS的处理方式更“闭源”，你没法像Windows那样通过修改注册表的方式去搞定，必须遵循macOS自己的逻辑来修。
2. 搞清楚幕后机制：Quick Look和缩略图缓存在扮演什么角色
在动手修复之前，我先花点篇幅讲讲macOS在缩略图这件事上的设计逻辑。很多人只知道访达能显示缩略图，却不知道这东西其实是一个独立的子系统在支撑，叫做Quick Look。苹果官方对它的描述是“快速查看”，也就是你按空格键预览文件内容的功能。但实际上，Quick Look承担的不只是预览，它还负责生成文件图标和缩略图。
macOS的缩略图不是每次打开访达都现场渲染的。你第一次进入某个文件夹时，系统会通过Quick Look框架把图片、视频等文件渲染成小尺寸的缩略图，然后写入缓存数据库。等你下次再打开这个文件夹，系统直接读缓存，不用再次渲染，所以速度快。这个设计思路本身没毛病，问题在于：缓存数据库一旦损坏、丢失、或者权限不对，系统就会出现各种“明明文件在，但缩略图就是出不来”的状况。
用我自己的话打个比方：这就像你家厨房的菜谱被撕了，厨师（Quick Look进程）不是不会做菜，而是没了参考就不知所措。你需要的不是换厨师，而是把菜谱重新整理一份。
在终端里，与Quick Look相关的常用命令是qlmanage。它有两个重要的参数：
qlmanage -r：重置Quick Look的缓存和缩略图数据库qlmanage -t -s 512 -o /tmp [文件路径]：指定尺寸单独生成一张缩略图，用来测试某个文件类型能不能正常渲染
我实测过很多次，qlmanage -r是修复缩略图问题非常有效的第一招，很多情况下一条命令就能解决，根本不用重启电脑。不过要注意，这条命令不会终止正在运行的quicklookd进程，所以有时候执行完命令你还是看不到变化，这时候需要配合重启访达来让新缓存生效。
另外还有几个关键的缓存路径，很多人清理系统垃圾时容易误删，但真出问题时你却需要主动去删：
~/Library/Caches/com.apple.finder：访达自身的缓存~/Library/Caches/com.apple.QuickLook.thumbnailcache：缩略图缓存数据库~/Library/QuickLook：用户级Quick Look插件目录/Library/QuickLook：系统级Quick Look插件目录
理解这些机制之后，接下来的排查思路就清晰多了：要么是缓存坏了，要么是Quick Look插件出了问题，要么是文件本身的属性有问题。下面逐步展开。
3. 第一招：重建缓存——从killall Finder到清除thumbnailcache完整操作
绝大多数缩略图不显示的问题，根源就在缓存上。我建议按下面的顺序层层递进，每步操作成本都不高，你可以逐步测试，到哪一步恢复正常就停在哪一步。
3.1 最轻量的操作：重启访达进程
在终端执行：
killall Finder这个操作会强制重访达，你的访达窗口会重新打开。如果你只是偶尔一次遇到缩略图不显示，这招往往就有效。它的原理是让访达重新读取缓存数据库，如果数据库本身没坏，只是进程卡住了，重启后自然就好了。
但我要提醒一句：killall Finder不会清掉任何缓存，它只相当于让系统“重新读一遍菜单”。如果你的问题反复出现，光靠这招治标不治本。
3.2 重置Quick Look缓存：qlmanage -r
终端执行：
qlmanage -r这条命令会把所有用户的Quick Look缓存和缩略图缓存重置。我实测下来，它能解决大约六成“缩略图莫名其妙没了”的问题。
需要注意的是，qlmanage -r执行完不会立刻生效，因为quicklookd进程还在跑。建议你执行完再执行一次killall Finder，必要时重启电脑。很多人说“我执行了命令没用”，多半是没做这一步，缓存虽然重置了，但旧进程还在用旧状态，自然看不到效果。
3.3 手动删除缓存数据库
如果前两步都没用，就得来硬的了。彻底删除缩略图缓存数据库，让系统重建：
rm -rf ~/Library/Caches/com.apple.QuickLook.thumbnailcache rm -rf ~/Library/Caches/com.apple.finder killall Finder执行完这几条命令后，访达会重新扫描目录并生成缩略图。第一次重新进入大文件夹的时候可能会有点卡，因为系统在批量渲染，这个过程是正常的。
这里有一个很容易被忽略的操作细节：删完缓存之后，你最好把访达完全退出（按Cmd+Q），再重新打开，而不是只关掉所有窗口。访达有个特性，关掉所有窗口后进程可能还驻留在后台，这时候它会继续持有已删除的缓存句柄，导致你看着还是老样子。只有彻底退出再进入，系统才会完全重新初始化。
3.4 针对单独文件的测试：qlmanage手动生成缩略图
如果你不确定是“整个系统的缩略图功能坏了”还是“某个具体文件类型不支持”，可以用这个命令单独测试：
qlmanage -t -s 512 -o /tmp /path/to/your/file.jpg这条命令的意思是：以512x512的尺寸生成该文件的缩略图，输出到/tmp目录。如果这条命令能成功生成图片，说明Quick Look框架本身没坏，问题大概率出在访达缓存，按上面步骤清理就能解决。如果命令报错，或者输出的是一个空白图片，那就要怀疑是该文件类型对应的解码组件或Quick Look插件损坏了。
我遇到过一个典型的案例：一位用户的Mac突然所有PDF文件都没了缩略图，但图片和视频正常。我用qlmanage测试PDF文件时发现渲染失败，最后定位到是系统预览框架里PDF解码组件的问题，卸载了一个第三方PDF工具后重启就好了。这个案例也印证了一个重要的排查思路：不要一上来就清理全部缓存，先用单个文件测试锁定范围，效率会高得多。
4. 被忽略的隐形杀手：隔离属性与“你尝试预览的文件可能对你的计算机有害”
热词里有一条很有意思：“你尝试预览的文件可能对你的计算机有害。如果你信任此文件以及其来源，请打开此文。” 这是很多Mac用户在访达中双击从网络上下载的文件时会看到的提示。很多人问这跟缩略图不显示有什么关系？关系很大。
macOS对从互联网下载的文件都会打上一个隔离标记，叫com.apple.quarantine。你可以把它理解为系统给文件盖了一个“外部来源”的章。凡是有这个标记的文件，系统在打开时会弹窗询问你，同时也会影响文件某些元数据的读取。
具体到预览上，有些用户遇到的情况是：普通文件缩略图正常，唯独从微信、浏览器、网盘下载的那批文件全部没有缩略图，或者显示成通用图标。这时候你打开终端看一眼：
xattr -l /path/to/downloaded/file.pdf如果输出里能看到com.apple.quarantine这条属性，那就能基本锁定问题了。解决办法是移除这个属性：
xattr -dr com.apple.quarantine /path/to/your/folder注意我用的是-dr而非-d，-r表示递归处理整个文件夹里的所有文件。执行完再killall Finder刷新一下，多数情况下缩略图就能正常显示了。
我不建议你为了解决缩略图问题，盲目地对全盘文件执行这个命令。因为隔离属性本身是macOS安全机制的一部分，去掉之后你的系统相当于失去了对来源不明文件的第一层警示，一旦你真双击了一个恶意文件，就再也没有拦截提示了。我自己的习惯是：只在确定安全的文件上执行，比如自己刚用微信传过来的工作文档、自己下载的正规软件安装包，仅仅因为预览问题就批量去隔离属性，风险大于收益。
顺便说一句，在你遇到的报错里还有一条是“outlook不能预览此文件，因为以下预览程序发生错误pdf preview handler”，这是Windows平台的问题，但精神是一致的：系统预览依赖某个具体的“handler/组件”，组件坏了，预览就废了。macOS里对应的就是Quick Look插件系统，下一节细说。
5. Quick Look插件冲突：第三方预览组件引发的“部分文件预览失灵”
macOS的Quick Look架构是支持插件的，开发者可以编写第三方的qlgenerator插件来让访达支持更多文件格式的预览。这个东西用好了很强大，但用不好就是你排查噩梦的根源。我见过不少人装了一堆插件之后，某天突然发现某种格式的缩略图全变成空白，然后百思不得其解。
结合热词里“outlook不能预览此文件，因为以下预览程序发生错误pdf preview handler”这类问题，我强烈怀疑配置文件或预览组件损坏，是很多预览类故障的真正元凶。
5.1 如何排查Quick Look插件问题
首先看这个目录里装了什么：
ls -la ~/Library/QuickLook ls -la /Library/QuickLook前者是当前用户的插件，后者是全系统共享的插件。macOS系统自带的Quick Look插件是在系统层面的，用户一般不需要动，但第三方安装的插件如果和系统冲突，就会导致对应的文件类型缩略图生成失败。
排查方法也很直接：把可疑的插件先移出目录，重启quicklookd：
mkdir ~/Desktop/ql_backup mv ~/Library/QuickLook/* ~/Desktop/ql_backup/ qlmanage -r killall QuickLookUIService 2>/dev/null killall Finder然后把插件一个个放回去，每放一个就测试一下对应的文件预览。这个过程虽然笨但非常有效，能精确定位到是哪个插件出了问题。
5.2 查看系统日志找具体报错
如果你不想一个一个试，可以直接看日志。打开“控制台”App，搜索quicklookd或qlmanage，然后在访达里刷新你要测试的文件夹，回控制台看对应时间戳的报错信息。日志里通常能直接看到崩溃的插件路径和原因，省去盲目尝试的工夫。
我曾经遇到一个案例：升级macOS大版本后，某种视频格式的缩略图全部消失。排查日志发现是某个老旧的视频预览插件不兼容新版系统，每次加载就崩溃。把那个插件禁用后，一切恢复正常。这个案例告诉我们一个通用原则：每次macOS大版本升级后，如果遇到“原来能用、现在不能用”的预览问题，优先怀疑第三方插件，而不是怀疑系统坏了。
5.3 一键重置Quick Look服务
除了上面那种手动方式，你也可以用这条组合命令来重置Quick Look服务状态：
killall quicklookd killall QuickLookUIService qlmanage -r killall Finder前面四章我们分别解决的是缓存、属性、插件问题，而这一条组合命令是把Quick Look进程和缓存一起重置，适合上述方案都无法定位或者你不想细究原因的时候直接来一发。有效概率不小，但请注意，它同样治标不治本——如果底层插件有冲突，下次还是会复发。
6. 权限问题：终端没权限、完全磁盘访问权限与“假性失灵”
热词里有一条“macos 终端完全没权限了”，这个描述和缩略图问题也有千丝万缕的联系。听我说，这不是巧合，权限问题在macOS里往往以连锁反应的形式出现。
6.1 完全磁盘访问权限（Full Disk Access）
macOS的沙盒机制很严格，访达和Quick Look进程本身有访问磁盘的权限，但如果你是第三方开发者、或者用了某些定制工具去生成缓存，就会遇到“权限不足导致无法写入缓存”的问题。此时文件能看能打开，但缩略图永远生成不了，看起来就是预览失灵。
尤其是从旧版本升级上来的Mac，TCC（Transparency, Consent, and Control）权限数据库有时会混乱，导致访达无法正常读取某些目录的元数据。你可以在“系统设置 → 隐私与安全性 → 完全磁盘访问权限”里检查一下，看访达或者相关进程是否被意外限制了。如果这里异常，可以先把它关闭再重新添加，触发系统重新授权。
6.2 终端本身没权限怎么办
更极端的场景是终端里执行ls都提示权限不足，sudo也报错。这种情况就不是缩略图的问题了，而是整个用户权限体系出了问题。我见过有人用第三方清理工具误改了系统目录的权限，结果整个用户目录变成了只读。这种情况下，你用任何命令去删缓存都是没用的，因为根本没权限写。
解决的步骤是重启到恢复模式，用“磁盘工具”的“急救”功能修复磁盘权限。注意不要随意用chmod去改系统目录权限，很多人越改越糟。如果磁盘工具急救无法解决，最保守的方案是备份数据后重装系统，不要想着手动修复所有权限位，成本太高且容易漏。
6.3 权限问题与缩略图故障的典型关联
再往深里说，Quick Look的缓存数据库文件，默认归属于你的用户账户。如果某些操作让它变成了root所有，或者权限位变成了600，当前用户就无法读取它，自然就无法显示缩略图。这种故障表现为：其他账户登录同一个Mac时缩略图正常，只有你的账户不正常。我建议遇到这种情况时直接检查一下文件属主和权限：
ls -la ~/Library/Caches/com.apple.QuickLook.thumbnailcache/如果你看到数据库文件的属主明显不对，且你确定该文件没有其他用途，可以直接删除重建，让系统重新生成正确的属主与权限。记住，删缓存永远比改权限好用，因为改权限容易改错，删了它系统会按默认配置再建一份，干净利落。
7. 磁盘与文件系统异常：隐藏的缩略图杀手
热词里“macos和系统数据储存占了很多”也很值得拿出来聊。我遇到过多起缩略图不显示的案例，最终根因不是缓存，不是插件，而是磁盘空间被系统数据塞满了，导致Quick Look根本没有足够的临时空间来生成缩略图。
7.1 系统数据暴涨与缓存空间不足
macOS的“系统数据”分类有时候会膨胀到几十GB，其中包括了各种缓存、日志、快照等。当你的主磁盘剩余空间低于一定数值时，系统会进入“低磁盘空间保护模式”，此时大量非关键后台任务会被暂停或降级，而缩略图这种“锦上添花”的功能首当其冲受影响。
你可以看看自己磁盘剩余空间：
df -h /如果可用空间只剩几个GB，那先别急着清理缩略图，先把磁盘空间释放出来。常见的大头包括：
- Time Machine的本地快照（可以用
tmutil listlocalsnapshots /查看） - 系统缓存（
~/Library/Caches下的内容） - 各种App的支持文件
- 下载文件夹里堆积的安装包
清理完磁盘空间后，再执行一次qlmanage -r和killall Finder，很多时候就直接恢复正常了。
7.2 APFS快照带来的“空间已满”假象
Mac的APFS文件系统有快照机制，这也是“系统数据”经常飙高的原因之一。如果你的Time Machine开启了“本地快照”功能，它会在后台对你的磁盘做快照，这些快照会占空间但你看不到具体文件。快照太多时，即使你删了大文件，可用空间也可能不会立刻增加，因为快照还持有那些被“删除”的数据块。
这种状态下，Quick Look同样无法正常写入缓存。你可以用以下命令查看并清理本地快照：
tmutil listlocalsnapshots /清理的话，可以进入Time Machine设置里关闭本地快照，或者用磁盘工具做一次维护。清理完快照，磁盘空间会立刻释放，缩略图问题也会缓解。
7.3 文件系统异常时先做“急救”
还有一种情况，磁盘文件系统本身有错误，导致访达读文件元数据时卡顿或失败。这种情况不只是缩略图不显示，你可能会发现复制文件、打开文件也伴随异常。修复方式是在“应用程序 → 实用工具 → 磁盘工具”里选择你的启动盘，点击“急救”，运行“验证磁盘”和“修复磁盘”。这个操作不破坏数据，可以放心执行。
但是要提醒一句：磁盘急救不能修复所有问题，尤其是APFS快照层面的逻辑错误，有时候急救显示“成功”但问题仍在。这时候备份好数据、格式化重装也是可行选项，别死磕。
8. 重装与恢复模式的正确打开方式
说到重装，热词里也确实有“macos重装”、“macos镜像iso下载”这些相关词。虽然我前面花了大量篇幅讲各种“不用重装就能解决”的方案，但确实存在必须重装才能搞定的局面。关键在于，你要判断值不值得重装，以及如何重装才不会伤筋动骨。
8.1 什么时候才真的需要重装
我个人的判断标准是这样的：如果以上所有方案都试过，并且你确认不是单一文件或单一文件夹的问题，而是整个系统的预览功能全面瘫痪，包括系统自带的“预览”App都无法正常渲染，那才考虑重装。
另外还有两种情况，也建议直接重装而不是继续排查：
- 系统目录权限彻底混乱，磁盘急救无效
- 你曾经用不正规方式修改过系统核心文件，导致无法确定哪里的改动引出了问题
8.2 重装系统有哪些路径
macOS重装有三种常见路径：
恢复模式重装：重启按住Cmd+R，从自带的恢复分区重装系统。这个方式保留数据，但只安装系统本身，不动你的文件和App。适合系统文件损坏，但数据还可以救的情况。
开机选项重装：Apple Silicon芯片的Mac，重启后长按电源键进入开机选项，选择“选项”进入恢复模式，操作逻辑类似。
制作启动U盘重装：需要准备一个16GB以上的U盘，用“创建安装器”功能制作，适用于需要全新安装的场景。
不管你选哪种，重装前必须有备份。Time Machine备份一次，再手动把关键工作目录复制到移动硬盘。做双保险，避免极端情况。
8.3 重装后如何快速恢复缩略图功能
其实重装系统后，缩略图功能会100%恢复，因为整个Quick Look框架和缓存数据库都被重建了。但我也要提醒你，重装后第一个容易踩的坑是：从Time Machine恢复完数据后，缩略图可能还是会有一段时间“生成缓慢”。这不是故障，是系统在后台大量重建缩略图缓存，尤其是照片库、视频文件夹特别大的时候，系统负载较高。
这时候不要急着杀进程，给系统一点时间。如果过了几个小时发现缩略图还是空白，再用前面的qlmanage -r和killall Finder组合处理一次即可。
9. 最后的个人经验：按这个顺序排查，能省下一整天时间
把这几年在Mac上修预览问题的经验浓缩成一条路径，你可以直接照做：
- 先重启访达（
killall Finder），低成本试错。 - 用
qlmanage -t -s 512 -o /tmp [文件]测试，判断是单个文件类型还是全局问题。 - 全局问题跑
qlmanage -r+ 重启访达；单个类型问题排查对应的Quick Look插件。 - 还没解决就删缩略图缓存数据库。
- 检查下载文件的隔离属性，处理
com.apple.quarantine。 - 观察磁盘剩余空间和“系统数据”占用。
- 控制台里看quicklookd日志，精确定位崩溃组件。
- 以上全无效、且全局崩溃，才考虑恢复模式重装。
这里头最关键的一点是：一定要先判断范围，再做处理的深度。不要一上来就重装，也不要一上来就删库。每次动手前先想清楚“这一步能不能让我知道问题的边界在哪里”，你会少走很多弯路。
我自己曾经因为偷懒，在遇到缩略图问题时直接走了重装这条路线，结果装完系统通宵重建照片库缩略图，第二天又遇到第三方插件冲突，等于白折腾。后来老老实实按上面的顺序排查，大多数情况在第三步就解决了。Mac这东西，系统本身很稳，出问题往往是缓存和权限这类“小毛病”，不要动不动就核武器伺候。把这篇文章收藏好，下次再遇到访达预览罢工，按顺序一步步来，一小时之内基本能搞定。
