Linux下du命令限制显示级数方法

本文深入解析了 Linux 下 `du` 命令中 `--max-depth` 参数的正确用法与常见陷阱：它能精准控制磁盘使用情况的统计深度（如 `--max-depth=1` 仅显示目标目录下一级子项大小），但会与 `-s`（汇总）选项互斥——一旦启用 `-s`，`--max-depth` 将被静默忽略；同时强调该参数为 GNU 特有，macOS 和 BusyBox 等非 GNU 环境需借助 `find -maxdepth` 组合替代，并提醒用户注意等号语法、隐藏文件处理及跨平台脚本的兼容性风险，帮你避开调试黑洞，高效定位空间大户。

du --max-depth=1 只显示一级子目录大小

当你执行 du -sh /var，默认会递归统计所有嵌套子目录，输出成百上千行。加 --max-depth=1 后，du 仅统计 /var 直接下的每个子项（如 /var/log、/var/cache），不钻进 /var/log/journal 这类二级路径。

常见误用是写成 --max-depth 1（漏掉等号）——多数 GNU 版本会报错：du: unrecognized option '--max-depth 1'；必须用等号连接。

• du -sh --max-depth=1 /var：按人类可读格式，只列一级子目录总大小
• du -h --max-depth=1 /var | sort -hr：加上排序，一眼看出哪个子目录最占空间
• 深度为 0（--max-depth=0）等价于只显示目标目录自身总大小，和不加该参数但加 -s 效果一致

为什么 --max-depth 不影响 du -s 的行为

du -s 本身表示“汇总”，它天然忽略中间层级，只输出一个总数。此时再加 --max-depth 是冗余的——du -sh --max-depth=3 /home 和 du -sh /home 输出完全一样，都是 /home 下全部内容的合计。

换句话说：--max-depth 只在未使用 -s 时生效；一旦用了 -s，它就自动退化为“只算顶层”。想看多级结构又不想太深，得去掉 -s，靠 --max-depth 控制展开层数。

• 要分层查看：用 du -h --max-depth=2 /etc（显示 /etc 及其下两级，如 /etc/apt、/etc/apt/sources.list.d）
• 要汇总总数：直接 du -sh /etc，不必加 --max-depth
• 混用 -s 和 --max-depth 不报错，但后者被静默忽略

非 GNU 系统（如 macOS 或 BusyBox）不支持 --max-depth

macOS 自带的 du 来自 BSD，没有 --max-depth 参数，运行会提示：du: illegal option -- -。BusyBox 中的 du 同样不支持。

替代方案只能靠 find 配合 du 模拟：

find /var -maxdepth 2 -mindepth 1 -type d -exec du -sh {} + | sort -hr

这段命令含义是：从 /var 开始，只找深度为 1～2 的目录（即 /var/xxx 和 /var/xxx/yyy），对每个目录单独执行 du -sh，再排序。注意 -maxdepth 2 对应 --max-depth=2 的效果，但实现更啰嗦、性能略低（多次调用 du）。

• GNU du（Linux 主流发行版）：优先用 --max-depth，简洁可靠
• macOS：必须用 find + du 组合，且 find 的 -maxdepth 是小写 d，别写成 -MaxDepth
• 脚本中若需跨平台，建议先检测 du --version 是否含 GNU coreutils

排序和过滤大目录时，--max-depth 容易漏掉隐藏目录

du --max-depth=1 默认会统计以 . 开头的隐藏目录（如 .cache、.local），但如果你加了 -a（显示文件）或配合 grep 过滤，可能意外排除它们。

例如：du -sh --max-depth=1 ~ | grep -v "^\." 看似想排除隐藏项，实则把整行（含大小和路径）都过滤了——因为 ~/.cache 输出形如 1.2G /home/user/.cache，开头不是点，grep -v "^\." 压根不匹配，反而可能漏掉真正以点开头的路径（如当前目录名就是 .tmp）。

• 安全过滤隐藏项：用 du -sh --max-depth=1 ~ | awk '$2 !~ /^\./'
• 只想看隐藏项：用 du -sh --max-depth=1 ~ | awk '$2 ~ /^\./'
• 注意字段分隔：默认空格不固定，用 awk 比 cut -d' ' -f2 更稳

实际用的时候，深度控制本身很简单，难的是记住它和 -s 的互斥关系，以及跨平台时的 fallback 方式。尤其在写部署脚本时，别假设所有机器都有 GNU du。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。