本文信息：基于 SpacePeek v1.1（2026-06-19）编写，测试环境 macOS 15.0 Sequoia / MacBook Pro M3 Pro。该工具当前活跃开发中，截至发稿最新版本为 v1.1。

一、问题背景

我遇到了什么痛点

过去半年，我的 Mac 256GB 硬盘一直处于"濒临爆满"状态。每次系统弹出「磁盘空间不足」通知，我都要经历以下流程：

1. 打开 Finder，凭记忆猜测哪个文件夹可能最大

2. 逐个文件夹右键 →「显示简介」

3. 等 Finder 花 3~8 秒计算文件夹大小

4. 记下数字，换下一个文件夹继续右键

5. 反复 10+ 次之后，终于找到元凶——通常是某个忘删的 Docker 镜像缓存或node_modules

整个流程耗时 5~10 分钟，而且每次都要重复这个低效操作。

为什么现有方案不够好

核心矛盾：我需要的是一个轻量级的即时查询方案——在 Finder 日常浏览文件时，随手就能知道"这个文件夹到底多大、里面什么东西最大"，而不是专门打开一个重型分析工具。

阅读收益

读完本文你会知道：

• SpacePeek 能做什么、不能做什么

• 如何 1 分钟装好并上手

• 一个完整的真实清理案例（从发现到清理完毕）

• 安装配置中的踩坑和解决办法

• 什么场景适合用它，什么场景不适合

二、SpacePeek 是什么

一句话定义

SpacePeek是一个 macOS Quick Look 扩展插件——选中任意文件夹，按空格键，直接在 Finder 里看到文件夹总大小、文件数量、最大子目录排名和存储分布，全程不离开 Finder。

核心亮点

• 零上下文切换：不从 Finder 跳转到其他 App，按空格即看

• 即时扫描：Rust 引擎本地扫描，不建索引、不后台常驻

• 存储分布图：交互式饼图，一眼看到哪个子文件夹占空间最多

• 全本地处理：零网络连接、零数据上传、零追踪

• Git 自动检测：选中 Git 仓库文件夹时显示分支、最近提交等仓库元信息

同类工具对比

选择理由：我最终选择 SpacePeek 而不是 DaisyDisk，是因为我需要的是"日常随手查"而不是"季度大扫除"。DaisyDisk 的强大在于全盘清理，但每次打开等扫描的时间成本太高。SpacePeek 填补的是"浏览文件夹时顺便知道大小"这个高频但一直被忽视的场景。

三、快速上手

安装

SpacePeek 只有一个安装渠道——Mac App Store：

App Store 搜索 "SpacePeek" 或直接访问：https://apps.apple.com/us/app/spacepeek/id6777129953

• 系统要求：macOS 14.0 (Sonoma) 及以上

• 安装包大小：约 4 MB

• 安装方式：从 App Store 下载后自动完成，无需额外配置

⚠️ 首次安装后必须操作

安装完成后你可能会发现选中文件夹按空格仍然显示系统默认的"文件夹"预览，而不是 SpacePeek 的界面。

原因：macOS 需要你手动启用第三方 Quick Look 扩展。

解决步骤：

1. 打开「系统设置」→「通用」→「登录项与扩展」

2. 点击「Quick Look」（快速查看）

3. 找到SpacePeek，打开开关

4. （可选但推荐）将 SpacePeek拖到列表最顶部，确保它优先于其他 Quick Look 扩展

⚠️ 如果你之前安装过 Folder Preview 或 Folder Quick Look 等同类工具，多个 Quick Look 扩展会竞争同一个文件夹预览。确保 SpacePeek 排在最前面即可。

验证是否生效：

1. 打开 Finder，选中任意文件夹（建议选一个有内容的目录）

2. 按空格键

3. 你应该看到这样的界面：

（此处配图：SpacePeek 预览面板效果——顶部显示文件夹名和总大小，左侧饼图，右侧 Top 文件列表）

四、核心功能详解

功能一：存储总览 —— 替代「右键→显示简介」

使用场景：日常浏览文件时，看到某个文件夹，想知道它到底占多少空间。

操作：选中文件夹 → 按空格。

你会看到：

• 顶部：文件夹名称 + 总大小（如 “12.4 GB”）

• 中部：文件数量和子文件夹数量

• 右侧面板：存储分布交互式饼图（各子目录的占比一目了然）

> 对比：右键 → 显示简介需要等待 3~8 秒且每次只能看一个数。SpacePeek 的饼图让你一眼识别"哪个子文件夹是罪魁祸首"。

关键参数：无需任何参数配置。扫描速度取决于文件夹内的文件总数（不是总大小），实测一个含 50 万文件的node_modules约 1.5 秒出结果。

功能二：空间占用排名 —— 精准定位大文件

使用场景：你知道这个文件夹很大，但想知道里面什么东西最大。

操作：在 SpacePeek 预览面板中，向下滚动到「Largest Files」区域。

你会看到：按大小降序排列的文件列表，每一行显示文件名和对应的空间占用。

实战价值：有一次我发现 Downloads 文件夹占了 23GB，点进去排名一看——排在第一位的是一个 14GB 的.dmg安装包，是半年前下载的 Xcode 更新。

没有这个排名视图的话，我得在 Downloads 里一个个文件点过去——几百个文件，根本找不出来。

功能三：Git 仓库检测 —— 给开发者的惊喜

使用场景：管理几十个本地 Git 仓库，有时忘了哪个项目在哪个分支、上次提交是什么时候。

操作：选中任意 Git 仓库文件夹 → 按空格。

额外显示：在预览面板中，SpacePeek 会自动识别并显示：

• 当前分支名

• 最近一次提交的哈希和消息

• 仓库状态（是否有未提交的更改）

这比在终端里cd进去再git status快得多，也比你打开 Sourcetree 或 GitKraken 轻量得多。

功能四：文件年龄分析 —— Downloads 文件夹的救星

使用场景：Downloads 文件夹日积月累变成黑洞，想知道哪些是"陈年老文件"可以放心删除。

操作：选中 Downloads 文件夹 → 按空格 → 查看「File Age」分析区域。

你会看到：按时间段（最近 7 天/30 天/半年/一年以上）分组的文件统计。

实战价值：你可以快速判断——“超过半年的文件占了 60% 空间，这些大概率是可以删的安装包和临时文件。”

功能五：Pro 无限下钻（付费功能）

使用场景：你从一个大文件夹的饼图看到一个子文件夹占了 80%，想继续深入看它里面又是什么。

操作（需购买 Pro，$1.99 一次性买断）：

1. 选中一个大文件夹 → 按空格看到总览

2. 在饼图中双击某个占比较高的子文件夹

3. SpacePeek 直接在预览窗口中展示该子文件夹的存储分析

4. 继续双击，可以一直下钻到任意深度

> 全程不离开 Finder、不打开 Finder 新窗口、不切到任何 App。

五、实战案例：清理 Mac 磁盘中的 30GB 隐藏占用

需求描述

某天系统提示「磁盘剩余空间不足 5GB」，但我粗略估计自己的文件不可能占满 256GB 硬盘。我需要快速定位到底是什么在吃空间。

操作过程

第 1 步：打开 Finder → 进入个人目录~/

选中Library文件夹 → 按空格 → SpacePeek 显示：52.3 GB

饼图显示，Containers子文件夹占了 38 GB。

第 2 步：双击饼图中的Containers（Pro 功能）→ 饼图刷新

发现com.docker.docker占 22 GB，com.apple.dt.Xcode占 12 GB。

第 3 步：继续下钻到 Docker 的Data/vms目录 → 显示 18 GB 的.raw磁盘镜像文件。

第 4 步：继续下钻到 Xcode 的iOS DeviceSupport目录 → 显示多个旧 iOS 版本的调试符号文件，最大 4.5 GB/个。

输出与验证

最终释放空间：约 30 GB，磁盘从「不足 5 GB」恢复到「35 GB 可用」。

效果总结

整个过程从发现问题到清理完毕，耗时约 6 分钟。全程没有打开 DaisyDisk、没有开终端、没有一个一个右键显示简介。

如果没有 SpacePeek，同样的排查流程估计需要 20 分钟以上（主要是 DaisyDisk 全盘扫描时间 + 在 Finder 中手动定位路径的时间）。

六、踩坑记录

坑 1：装完没反应

现象：从 App Store 装好 SpacePeek 后，选中文件夹按空格，还是系统默认的蓝色文件夹图标。

排查过程：

1. 检查 App 是否启动成功 → 打开 SpacePeek.app，界面正常

2. 怀疑 Quick Look 扩展未注册 → 用终端检查：pluginkit -m | grep spacepeek，发现扩展已注册

3. 最终定位：Quick Look 扩展默认是禁用的

根因：macOS 对第三方 Quick Look 扩展的安全策略比较保守，用户必须手动到系统设置中启用。

解决方案：系统设置 → 通用 → 登录项与扩展 → Quick Look → 启用 SpacePeek（见第三章步骤）。

坑 2：与其他 Quick Look 扩展冲突

现象：启用 SpacePeek 后有时预览正常，有时还是旧的 Folder Preview 界面。

根因：macOS 同时安装了多个文件夹类型的 Quick Look 扩展（Folder Preview + Folder Quick Look + SpacePeek），系统按列表顺序选择第一个匹配的扩展。

解决方案：在系统设置 → Quick Look 扩展列表中，把 SpacePeek拖到最上方（优先级最高），其他扩展可保持启用或禁用均可。

七、边界与替代

适用场景 ✅

不适用场景 ❌

已知限制

• 无全盘扫描：每次只能分析当前选中的文件夹，无法一次性看到全盘 Top 占用排名

• 不读取隐藏文件（默认）：需要确认是否支持.xxx开头的隐藏文件/文件夹的扫描（官方未明确说明）

• 无删除/操作功能：SpacePeek 是纯查看工具，不能直接删除文件或清空文件夹——你需要在 Finder 中自行操作

• 仅 macOS：无 Windows/Linux 版本，也不在开发计划中

维护状态

截至本文发稿（2026-07-09），SpacePeek 处于活跃开发阶段：

• 首个版本 v1.0 发布于 2026-06-16

• 最新版本 v1.1 发布于 2026-06-19（仅间隔 3 天）

• GitHub 仓库活跃，开发者对 Issue 有响应

• 项目为个人开发者项目，如果作者弃坑有一定断更风险，但代码开源（GitHub），可被 Fork 继续维护

八、总结

三点核心

1. SpacePeek 解决的是一个高频但一直被忽视的痛点：在 Finder 里随手知道文件夹占用多少空间。这对开发者、设计师和所有 Mac 重度用户来说，是一个"用过就回不去"的体验提升。

2. 它不是 DaisyDisk 的替代品，而是补充品。DaisyDisk 适合季度大扫除，SpacePeek 适合日常随手查。两者配合使用效果最佳。

3. 免费版已经足够好用，$1.99 的 Pro 主要是解锁下钻导航——如果你经常需要逐层排查文件夹膨胀原因，Pro 值得买；如果只是日常随手查看大小，免费版完全够用。

版本信息

你还有哪些 Mac 上频繁遇到但一直没找到合适工具解决的痛点？欢迎在评论区聊聊——也许下一个工具推荐就是你的灵感来源。