摘要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 扩展安装后默认处于禁用状态需要用户手动在系统设置中开启。解决步骤打开「系统设置」左侧菜单 →「通用」→「登录项与扩展」在右侧列表中找到「Quick Look」或「快速查看」找到SpacePeek点击开关 → 变为蓝色已启用强烈推荐点击并拖拽 SpacePeek 到列表最顶部为什么拖到最顶部如果你之前安装过 Folder Preview、Folder Quick Look 或 PeekX 等同类工具多个 Quick Look 扩展会竞争同一个文件夹预览请求。macOS 按列表从上到下的优先级选择扩展。把 SpacePeek 拖到第一位可以确保它优先响应。验证方法回到 Finder选中任意文件夹按空格。如果看到文件夹大小、文件数量或饼图说明成功。如果还是不行# 检查扩展是否已注册pluginkit-m-v-pcom.apple.quicklook.preview|grep-ispacepeek如果有输出 → 扩展已注册但可能被其他扩展覆盖回到上一步调整顺序。如果没有输出 → 扩展未注册尝试重启 Mac 后重试。问题 2有时候能预览有时候又弹回系统默认界面现象SpacePeek 间歇性失灵——选 A 文件夹按空格正常显示选 B 文件夹又变回系统默认界面。换回 A 也不行了。根因macOS 的 Quick Look 扩展进程是有生命周期的。如果扩展进程崩溃比如扫描超大文件夹时内存溢出macOS 会回退到系统默认预览。排查步骤缩小扫描范围先找一个文件数少于 100 的小文件夹测试。如果能正常预览 → 说明 SpacePeek 本身没问题是某个大文件夹触发了进程崩溃。检查冲突扩展如果你同时装了多个 Quick Look 扩展Folder Preview、Folder Quick Look 等它们会在后台互相抢占。在这篇 FAQ 的问题 1中已经把 SpacePeek 拖到最顶部的步骤可以解决大部分冲突。重置 Quick Look 缓存qlmanage-rcachekillallFinder这不会删除任何数据只是让 macOS 重新加载所有 Quick Look 扩展。如果频繁崩溃可能是某个超大文件夹10 万 文件的扫描超过了 Quick Look 扩展的内存限制。这种情况下可以尝试 Pro 版的逐层下钻——先看顶层文件夹再双击进入子文件夹分批分析而不是一次性加载所有层级。问题 3Pro 升级了但没有解锁现象在 App Store 购买了 SpacePeek Pro$1.99但回到 App 里发现高级功能无限层级下钻仍然显示为锁定状态。根因v1.2 版本已经优化了 Pro 解锁的可靠性但以下情况仍可能导致解锁延迟App Store 的购买凭证尚未同步到本地App 没有重新启动以刷新购买状态Apple ID 登录状态异常解决步骤完全退出 SpacePeek⌘Q退出不是关掉窗口。可以在活动监视器中确认 SpacePeek 进程已结束。重新打开 SpacePeek 一次从 Applications 文件夹或 Launchpad 启动它。让它有机会向 App Store 查询购买凭证。如果还是锁定打开 App Store → 点击左下角你的 Apple ID →「已购项目」→ 确认 SpacePeek Pro 出现在列表中。如果不在说明购买未成功联系 Apple 支持。最后手段删除 SpacePeek → 重启 Mac → 从 App Store 重新下载。对于 IAP应用内购买App Store 会记住你的购买记录重新下载不会重复扣款。v1.2 的改进v1.2 版本专门优化了 Pro 解锁的状态检测逻辑。如果你用的是 v1.1 或更早版本建议先更新到 v1.2App 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.app2/dev/nullecho还在||echo已删除# 2. 彻底刷新 Quick Look 扩展列表qlmanage-rqlmanage-rcache# 3. 重启 Quick Look 服务killallFinder# 4. 重新从 App Store 下载安装# 5. 再次执行问题 1 的步骤系统设置 → Quick Look → 打开 SpacePeek 开关如果以上都不行重启 Mac。Quick Look 扩展的注册表在重启后会完全刷新。三、问题速查表现象第一步排查大概率根因装完完全没反应系统设置 → Quick Look → 打开开关扩展默认被禁用间歇性失灵确认是否只有大文件夹出问题 重置 Quick Look 缓存扩展进程崩溃或多扩展冲突Pro 没解锁完全退出 App → 重启 → 检查 App Store 已购项目购买凭证未同步预览显示不全等待进度条走完 切换 Contents 视图大文件夹扫描耗时重装无效执行完全卸载脚本 重启 Mac旧注册信息残留四、如果以上都不行SpacePeek 当前的版本是 v1.22026 年 7 月。因为是个人开发者的项目以下渠道可以联系开发者或社区GitHub Issuesgithub.com/wangfu91/SpacePeek — 在 Issues 页面描述你的问题附上 macOS 版本和 SpacePeek 版本官方邮箱wangfu91spacepeekhotmail.com提交问题时建议附上macOS 版本 → 关于本机SpacePeek 版本App Store → SpacePeek 页面是否安装了其他 Quick Look 扩展问题的具体现象最好有截图这篇 FAQ 能解决你的问题吗如果遇到了以上 5 个之外的奇怪情况评论区描述你的现象我来帮你排查。