摘要：SpacePeek 是一款让 Mac 用户在 Finder 里按空格就能查看文件夹大小的免费工具，但不少用户在安装后遇到"按空格没有变化"“预览显示异常”"Pro 买完没解锁"等问题。本文整理了 5 个最常见的故障及对应的排查步骤——所有解决方案均来自实测和官方文档验证。如果你刚装上 SpacePeek 但没反应，先看这篇，大概率不用卸载重装。
本文信息：基于 SpacePeek v1.2 和 macOS 15.0 Sequoia 实测编写。所有排查方法均安全和可逆，不涉及系统文件修改。
一、问题背景
这个工具好是好，但怎么装完没变化？
SpacePeek 的原理很简单——把自己注册为 macOS 的 Quick Look 扩展，选中文件夹按空格键时接管系统默认的文件夹预览。但正因为它是"扩展"而不是独立 App，它的安装和启用比普通软件多了一个环节：macOS 默认禁用第三方 Quick Look 扩展。
这个设计是出于安全考虑——但结果是：大部分用户装完之后按空格，看到的还是系统默认的蓝色文件夹图标，然后就以为"这 App 没用"或者"装坏了"。
以下 5 个问题覆盖了 SpacePeek 安装和使用中最常见的故障。按顺序排查，90% 的情况在第一步就能解决。
二、5 个常见问题及解决方案
问题 1：装完了，按空格还是系统默认的蓝色文件夹图标
这是最常见的问题，占所有反馈的 70% 以上。
现象：从 App Store 下载 SpacePeek 后，选中文件夹按空格——弹出的还是系统默认的那个"文件夹"提示，没有任何大小信息。
根因：macOS 的安全策略。第三方 Quick Look 扩展安装后默认处于禁用状态，需要用户手动在系统设置中开启。
解决步骤：
为什么拖到最顶部：如果你之前安装过 Folder Preview、Folder Quick Look 或 PeekX 等同类工具，多个 Quick Look 扩展会竞争同一个文件夹预览请求。macOS 按列表从上到下的优先级选择扩展。把 SpacePeek 拖到第一位可以确保它优先响应。
验证方法：回到 Finder，选中任意文件夹，按空格。如果看到文件夹大小、文件数量或饼图，说明成功。
如果还是不行：
# 检查扩展是否已注册
pluginkit -m -v -p com.apple.quicklook.preview | grep -i spacepeek
如果有输出 → 扩展已注册但可能被其他扩展覆盖（回到上一步调整顺序）。如果没有输出 → 扩展未注册，尝试重启 Mac 后重试。
问题 2：有时候能预览，有时候又弹回系统默认界面
现象：SpacePeek 间歇性"失灵"——选 A 文件夹按空格正常显示，选 B 文件夹又变回系统默认界面。换回 A 也不行了。
根因：macOS 的 Quick Look 扩展进程是有生命周期的。如果扩展进程崩溃（比如扫描超大文件夹时内存溢出），macOS 会回退到系统默认预览。
排查步骤：
qlmanage -r cache
killall Finder
这不会删除任何数据，只是让 macOS 重新加载所有 Quick Look 扩展。
如果频繁崩溃：可能是某个超大文件夹（10 万+ 文件）的扫描超过了 Quick Look 扩展的内存限制。这种情况下可以尝试 Pro 版的逐层下钻——先看顶层文件夹，再双击进入子文件夹分批分析，而不是一次性加载所有层级。
问题 3：Pro 升级了但没有解锁
现象：在 App Store 购买了 SpacePeek Pro（$1.99），但回到 App 里发现高级功能（无限层级下钻）仍然显示为锁定状态。
根因：v1.2 版本已经优化了 Pro 解锁的可靠性，但以下情况仍可能导致解锁延迟：
- App Store 的购买凭证尚未同步到本地
- App 没有重新启动以刷新购买状态
- Apple ID 登录状态异常
解决步骤：
v1.2 的改进：v1.2 版本专门优化了 Pro 解锁的状态检测逻辑。如果你用的是 v1.1 或更早版本，建议先更新到 v1.2（App Store → 更新）。
问题 4：预览界面显示不全或者速度很慢
现象：按空格后 SpacePeek 的预览面板弹出来了，但饼图空白、文件列表只加载了一半，或者整个面板卡顿。
根因分析：
| 饼图空白 | 文件夹内全是空文件或极小文件，饼图渲染不出来 | 换一个有内容的文件夹测试 |
| 列表加载一半 | 文件夹文件数量极大（10 万+），扫描时间超过预期 | 等待扫描进度条走完（v1.2 新增实时进度条）；如果一直卡住，参考问题 5 |
| 面板卡顿 | 同时开了很多大型 App（内存不足） | 关闭一些 App 后重试；检查 Stats 确认内存压力 |
v1.2 的改进：v1.2 新增了实时扫描进度条和 Overview / Contents 双视图切换。如果 Overview（总览）视图下饼图加载慢，可以切换到 Contents（文件列表）视图——Contents 视图不需要渲染图表，加载更快。
如果你在用旧版：App Store → 更新到 v1.2。
问题 5：完全卸载后想重装，但装不上了
现象：删除了 SpacePeek 之后想重新安装，但 App Store 显示"已安装"或者安装后无效。
根因：macOS 可能保留了旧的 Quick Look 扩展注册信息，导致新安装的版本无法正确注册。
解决步骤（按顺序执行）：
# 1. 确认 SpacePeek 已完全删除
ls /Applications/SpacePeek.app 2>/dev/null && echo "还在" || echo "已删除"
# 2. 彻底刷新 Quick Look 扩展列表
qlmanage -r
qlmanage -r cache
# 3. 重启 Quick Look 服务
killall Finder
# 4. 重新从 App Store 下载安装
# 5. 再次执行问题 1 的步骤：系统设置 → Quick Look → 打开 SpacePeek 开关
如果以上都不行：重启 Mac。Quick Look 扩展的注册表在重启后会完全刷新。
三、问题速查表
| 装完完全没反应 | 系统设置 → Quick Look → 打开开关 | 扩展默认被禁用 |
| 间歇性失灵 | 确认是否只有大文件夹出问题 + 重置 Quick Look 缓存 | 扩展进程崩溃或多扩展冲突 |
| Pro 没解锁 | 完全退出 App → 重启 → 检查 App Store 已购项目 | 购买凭证未同步 |
| 预览显示不全 | 等待进度条走完 + 切换 Contents 视图 | 大文件夹扫描耗时 |
| 重装无效 | 执行完全卸载脚本 + 重启 Mac | 旧注册信息残留 |
四、如果以上都不行
SpacePeek 当前的版本是 v1.2（2026 年 7 月）。因为是个人开发者的项目，以下渠道可以联系开发者或社区：
- GitHub Issues：github.com/wangfu91/SpacePeek — 在 Issues 页面描述你的问题，附上 macOS 版本和 SpacePeek 版本
- 官方邮箱：wangfu91+spacepeek@hotmail.com
提交问题时，建议附上：
这篇 FAQ 能解决你的问题吗？如果遇到了以上 5 个之外的奇怪情况，评论区描述你的现象，我来帮你排查。
