导出磁盘占用报告

整理项目、检查归档盘或记录某个工作目录的增长时，保存一份扫描报告，比只记住“现在大约多少 GB”更方便。DiskTreeSize 可以导出 CSV，也就是用表格软件打开的行列表，以及 JSON，也就是供程序读取、保留目录层级的数据文件。

两个格式都属于 Pro 功能，也就是应用内购买的付费功能或有效试用。免费扫描与目录分析不要求购买 Pro。

选择适合用途的格式

报告记录的是本次扫描结果。它不是文件内容备份，也不能用来恢复被移除的文件。

从分析位置到保存报告

1. 点击 选择位置，选择需要留存记录的项目或文件夹并开始分析。
2. 等待扫描完成。若之前看到的是保存的旧结果，先点击 重新扫描 再等待完成。
3. 点击工具栏 导出 → 导出 CSV… 或 导出 JSON…。
4. 在保存窗口选择位置，按用途命名，例如 project-before-2026-10-03.csv。
5. 打开保存的文件，核对根目录、大小字段和所需条目是否在报告中。

没有扫描数据时，导出入口不可用。如果看到 Pro 提示，需要有效试用或已购买权限；首次请求 Pro 功能时可主动领取 30 天试用，到期不会自动扣费。

导出范围从本次扫描的根目录开始。 在树中只选中一个子目录，并不会把报告范围缩到那个子目录。只想记录某个项目时，用“选择位置”单独分析它，再导出。

CSV 里的列怎样读

导出中的大小保留字节数，不使用界面里的自动单位。想在表格中换算为十进制 GB，可以把数值除以 1000000000，并给新列注明单位。两种大小的解释见 实际占用与逻辑大小指南。

不要把所有行的大小相加。 文件夹大小已包含后代项目，报告又有子项行；父文件夹与子项一起相加，会重复计算。比较顶层项目时，应筛选同一父目录下的项目，或只比较一条相同路径的前后值。

JSON 保留哪些资料

JSON 的 tree 包含名称、路径、是否为目录、逻辑大小、实际占用、数量和修改时间。导出的层级使用 children 表示子项目；有扫描汇总时，summary 还包括扫描数量、大小、跳过数量与用时。

这是一次扫描的记录，不是实时监听，也不是可恢复原文件的备份。修改目录后，需要重新扫描并再次导出。

当前导出有范围和数量限制

当前版本导出最多展开到扫描根目录下面 5 层，每个目录最多读取 10000 个子项，并有总量限制；CSV 整体最多 200000 行。数量很大或层级很深时，不能把报告当成完整逐文件清单。

如果需要记录更深的项目，先把那个子目录作为新的扫描位置，再单独导出。报告仍受访问权限限制，不会补全被跳过的文件。确认关键路径已出现在保存的文件中，再用它做比较。

怎样比较整理前后

保持同一磁盘、同一扫描位置和相同统计方式，分别保存前后两份 CSV。比较时按 Path 对齐，并使用同一大小列；应用当前没有自动比较两份报告的功能。

例如，整理项目导出文件后，比较该项目路径的 Allocated (bytes) 是否减少，再看系统的实际可用容量。目录报告的差值不能直接承诺为释放空间，也不能还原 macOS 的系统数据分类。

报告包含真实文件路径和名称。应用内“用户目录显示替换”设置只影响界面，不会自动替换报告里的路径；需要分享时，先检查并处理不希望公开的名称和路径。