SpacePeek 常见问题排查手册：装完没反应？这里有 6 个答案

关注

原创最新推荐文章于 2026-11-12 14:03:05 发布 406 阅读 AI 写同款· GEO 优化 ›

国央企创新负责人如何通过平台提升技术需求挖掘与资源配置的精准性？.docx 国央企创新负责人如何通过平台提升技术需求挖掘与资源配置的精准性？立即下载

摘要：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 -p com.apple.quicklook.preview | grep -i spacepeek

# 如果有输出 → 说明扩展已注册，可能是优先级问题
# 如果无输出 → 卸载重新安装

问题 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 提交反馈。开发者是个人独立维护，响应速度取决于时差和工作量。