SpacePeek 常见问题排查手册：装完没反应？这里有 6 个答案-平芜编程栈

摘要：SpacePeek 安装后最常见的 6 个问题——装完按空格没反应、和其他 Quick Look 扩展冲突、Pro 购买后没解锁、大文件夹扫描慢、Git 仓库检测不出来、偏好设置找不到——本文逐一给出排查步骤和解决方案。如果你遇到任何 SpacePeek 使用问题，先看这篇。

本文信息：基于 SpacePeek v1.2（2026-07-10）及 macOS 15.0 Sequoia 编写。如后续版本有变更，请以 GitHub Issues 和 App Store 更新日志为准。

一、前言

SpacePeek 装完之后，最常见的反应不是"好用"，是"怎么没反应"

SpacePeek 是一个 macOS Quick Look 扩展——这意味着它的启动机制和普通 App 不同。普通 App 有一个图标，双击打开。Quick Look 扩展没有——它寄生在 Finder 的按空格预览流程里。

这个机制的好处是：无缝融入系统，不需要打开任何 App。

坏处是：一旦它不工作，你不知道去哪里排查。

以下 6 个问题，是我自己在使用过程中遇到的、以及在各平台的用户反馈中收集到的。每一个都有明确的排查步骤和解决方案。

二、6 个问题的排查指南

问题 1：装完 App，选中文件夹按空格还是蓝色文件夹图标

症状：从 App Store 下载了 SpacePeek，启动了一次，然后选中文件夹按空格——出来的还是系统默认的蓝色文件夹图标和"文件夹"三个字。

原因：macOS 对第三方 Quick Look 扩展的安全策略非常保守。你下载了 App、启动了 App，不代表 Quick Look 扩展被自动启用了。你需要在系统设置中手动打开。

解决步骤：

系统设置 → 通用 → 登录项与扩展 → 找到"Quick Look"（快速查看） → 找到 SpacePeek → 打开开关

如果列表里有多个 Quick Look 扩展，把 SpacePeek 拖到最顶部（确保它优先于其他文件夹预览扩展）。

验证：设置完毕之后，选中任意文件夹，按空格。应该看到 SpacePeek 的预览面板（大小、文件数、饼图），而不是系统默认的蓝色文件夹图标。

如果仍然不生效：

# 检查 Quick Look 扩展是否注册成功pluginkit-m-v-pcom.apple.quicklook.preview|grep-ispacepeek# 如果有输出 → 说明扩展已注册，可能是优先级问题# 如果无输出 → 卸载重新安装

问题 2：有时候正常、有时候还是系统默认预览

症状：SpacePeek 的预览面板有时出现、有时不出现，好像随机抽风。同一个文件夹，按两次空格可能出来两个不同的界面。

原因：你的 Mac 上装了多个文件夹预览类的 Quick Look 扩展（比如 Folder Preview、Folder Quick Look、PeekX 等）。当多个扩展都注册了public.folder这个 UTI 时，macOS 会按扩展列表的顺序选择第一个——但有时系统会"选择困难"，导致随机行为。

解决步骤：

系统设置 → 通用 → 登录项与扩展 → Quick Look → 把 SpacePeek 拖到列表最顶部 → 把其他文件夹预览扩展（Folder Preview / Folder Quick Look 等）关掉

如果你需要保留其他扩展的某些功能（比如 Folder Preview 的压缩包预览），可以保持它们开启但确保 SpacePeek 排在第一位。

问题 3：Pro 购买了但没解锁

症状：在 App Store 点购买 SpacePeek Pro（$1.99），钱扣了，但预览面板里的 Pro 功能（无限层级下钻）仍然不能用。

原因：IAP（In-App Purchase）状态检测偶尔会有缓存问题。App 可能没有立即拉取到最新的购买状态。

解决步骤：

1. 退出 SpacePeek（如果它有独立窗口的话） 2. App Store → 点击左下角你的头像 → 找到 SpacePeek → 确认购买状态显示"已购买" 3. 重启 Mac（简单粗暴但有效——强制 App 重新拉取 IAP 状态）

v1.2 版本已经改进了 Pro 解锁的可靠性检测。如果你还在用旧版本，App Store 更新到最新版可解决大部分此类问题。

如果仍然不生效：在 github.com/wangfu91/SpacePeek/issues 提交 Issue，附上你的购买凭证和 macOS 版本。

问题 4：大文件夹扫描时感觉"卡住"了

症状：选中一个文件数量很多的文件夹（比如含有 20 万文件的 node_modules），按空格后，SpacePeek 的预览窗口弹出了一两秒，然后才显示结果——中间好像"卡住"了。

原因：SpacePeek 的扫描引擎是 Rust 编写的并行遍历（非阻塞），但在扫描完成之前，预览窗口确实需要等待结果。对于超大文件夹，遍历本身是有物理耗时上限的。这不是 bug，是物理限制。

如何判断是否正常：v1.2 版本新增了实时扫描进度条。如果进度条在动，说明扫描正在进行中，不是"卡住"。以下是大致耗时参考：

文件夹规模	预期耗时
1000 文件	< 1 秒
10000 文件	1-2 秒
50000 文件	2-5 秒
100000+ 文件	5-15 秒

如果耗时远超上表，可能是其他后台进程正在同时访问该文件夹（如 Time Machine 备份、Spotlight 索引、杀毒软件扫描等），形成了 I/O 竞争。

问题 5：Git 仓库识别不出来

症状：选中一个 Git 项目文件夹按空格，SpacePeek 的预览面板没有显示 Git 分支名、提交信息等——只在 Overview 视图里出现了。

原因：可能是你没切到 Overview 视图。

解决步骤：

SpacePeek v1.2 有双视图： → Overview 视图（默认）：显示文件夹总览、大小、饼图 → Contents 视图：显示文件列表 Git 仓库的元数据显示在哪个视图，取决于你是否选中了项目的根 .git 目录还是项目文件夹。 选中包含 .git 的根目录，才会触发 Git 检测。

另外，如果.git文件夹被 Finder 隐藏了（macOS 默认隐藏），你仍然可以正常触发——选中项目根文件夹，按空格，Overview 视图应该自动显示 Git 信息。

如果仍然不显示：确认.git目录确实存在（在终端里ls -la确认）。

问题 6：我想改快捷键 / 偏好设置，但找不到设置面板

症状：SpacePeek 没有独立窗口、没有 Dock 图标、没有菜单栏图标。我想找它的设置面板，找不到。

原因：SpacePeek 是一个 Quick Look 扩展，不是一个独立 App。它的设计理念就是"不存在——直到你按空格的那一瞬间"。因此，目前版本没有独立设置面板。

当前可以做的事情：

开启/关闭 SpacePeek：系统设置 → 通用 → 登录项与扩展 → Quick Look
查看版本号：App Store → 点击头像 → App 列表 → SpacePeek
提交反馈：GitHub Issues

关于快捷键：SpacePeek 没有自己的快捷键——它复用的是 macOS Quick Look 的系统快捷键（空格键）。如果你想改 Quick Look 的快捷键，这在 macOS 中没有原生支持，但可以通过系统设置 → 键盘 → 键盘快捷键 → 找到"快速查看"来调整。

三、问题速查表

问题	最可能原因	最快解决方式
按空格没反应	Quick Look 扩展未启用	系统设置 → 扩展 → Quick Look → 开
随机不生效	多个 Quick Look 扩展冲突	把 SpacePeek 拖到最顶部
Pro 买完没解锁	IAP 缓存	重启 Mac
扫描"卡住"	大文件夹正常耗时	v1.2 有进度条，看它在动就正常
Git 检测不出来	可能没切到正确视图	确认选中了项目根文件夹
找不到设置面板	没有独立设置面板	这是设计，非 bug

四、总结

三点

SpacePeek 的问题 90% 和 Quick Look 扩展的启用/优先级有关。系统设置 → 通用 → 登录项与扩展 → Quick Look → 检查 SpacePeek 是否开启 + 是否排第一。搞不定的话，先确认这两步。
macOS 的 Quick Look 扩展机制和普通 App 完全不同——没有 Dock 图标、没有独立设置、需要手动启用。这不是 SpacePeek 的问题，是所有 Quick Look 扩展的共性。
如果排查完以上 6 个问题仍然无法解决，在 GitHub Issues 提交反馈。开发者是个人独立维护，响应速度取决于时差和工作量。