diskutil apfs list命令可层级化展示mac上apfs容器、宗卷及逻辑卷组结构，含类型、挂载点、大小、可用空间与快照数；配合-v参数、diskutil info及磁盘工具可深度诊断空间与配置问题。
如果您在Mac上需要确认APFS容器结构、宗卷分布或逻辑卷组组成，系统内置的diskutil apfs list命令可直接输出层级化磁盘拓扑。以下是执行该命令并解读结果的步骤：
一、在终端中运行diskutil apfs list命令
该命令以树状结构展示所有APFS容器及其内部宗卷，包括每个宗卷的类型（如“系统”“数据”“恢复”）、挂载点、大小、可用空间及快照数量，是诊断空间分配与卷组关系的基础手段。
1、打开“访达”，前往“应用程序”>“实用工具”，双击“终端”。
2、在终端窗口中输入：diskutil apfs list，然后按回车键。
3、等待命令执行完成，终端将逐级显示每个APFS容器、其所属物理磁盘标识（如disk0s2）、容器内各宗卷名称（如Macintosh HD、Macintosh HD - Data）及对应UUID。
二、识别输出中的关键字段含义
命令输出中每层缩进代表隶属关系：顶层为物理设备（diskX），次层为APFS容器（Container），最内层为宗卷（Volume）。理解字段有助于定位异常空间占用或缺失卷。
1、查找以"APFS Container"开头的区块，其后括号内为容器UUID，下一行“Capacity Ceiling”表示该容器总容量上限。
2、在容器区块内寻找"Volume"条目，每项含Name、Capacity、Free Space、Mounted At等字段；若“Mounted At”为空，说明该宗卷未挂载。
3、注意"Snapshots: X"行，数字X表示该宗卷当前关联的APFS快照数量，大量快照可能隐性占用可观空间。
三、结合diskutil info获取单个宗卷详细属性
当需深入查看某特定宗卷的文件系统版本、加密状态、配额设置或保留空间等参数时，diskutil info可提供比apfs list更精细的元数据。
1、从diskutil apfs list输出中复制目标宗卷的标识符，例如disk1s1或/dev/disk1s1。
2、在终端中输入：diskutil info disk1s1（将disk1s1替换为实际标识符），然后按回车键。
3、检查输出中"File System Personality"是否为APFS、“Encryption Type”是否为AES-XTS、“APFS Physical Store”是否指向正确容器。
四、使用diskutil apfs list -v启用详细模式
添加-v（verbose）参数可扩展输出内容，包含每个宗卷的区块分配详情、快照UUID列表及容器内宗卷间的共享空间实时计算依据，适用于高级故障排查。
1、在终端中输入：diskutil apfs list -v，然后按回车键。
2、观察输出中每个Volume下方新增的"Size"、"Used"、"Purgeable"和"Space Reserved"字段，其中“Purgeable”值反映macOS可自动清理的空间量。
3、若某宗卷的“Used”远高于其“Size”，表明存在大量不可见快照或本地时间机器快照，需进一步用tmutil listlocalsnapshots /验证。
五、通过磁盘工具图形界面交叉验证容器结构
图形化界面可辅助确认命令行结果的可视一致性，尤其在处理外置APFS驱动器或多容器配置时，避免因设备重插导致的设备节点变化干扰判断。
1、打开“访达”，前往“应用程序”>“实用工具”，启动“磁盘工具”。
2、在左侧边栏顶部选择“显示” > “显示所有设备”，确保物理磁盘、APFS容器和宗卷全部展开显示。
3、依次点击任一APFS容器，在右侧面板中核对“可用空间”与“已用空间”数值是否与diskutil apfs list中对应容器的“Capacity Ceiling”和“Used Space”一致。
