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”一致。

















