简介面向 Linux 初学者、运维人员以及需要频繁查看目录层级的开发者tree 命令源码安装包用于补齐系统中缺少树状目录展示工具的问题适合在 CentOS 等环境完成编译安装、命令验证和日常目录巡检练习。压缩包共 19 个文件约 57KB以 C 源码文件为主搭配头文件、Makefile、INSTALL、README、LICENSE 以及变更记录、待办说明和文档手册等分别对应编译构建、安装指引、许可说明与参数查阅结构较为完整。已有 4486 人学习下载在基础命令补齐和源码编译练习场景中具有较好的参考价值。读者可依据包内说明走通解压、编译安装与基础使用流程理解递归目录列表的深度缩进输出特点并将树状结构用于文件系统巡检、工程目录核对和自动化脚本编写前的快速排查。1. 从一句 command not found 说起tree 到底在目录里替你做了什么接手别人交接的项目最费时间的动作往往不是读代码而是看清这个目录里到底有什么。ls只给你一层find给的是平铺的一长串路径层级关系全靠脑补。tree 干的事很朴素把目录递归展开用缩进和连接符画成树哪个是源码、哪个是构建产物、哪个目录塞了三百个零散文件扫一眼就有数。麻烦在于这个命令在最小化安装、精简容器镜像里基本不预装敲下去直接回一句 command not found很多人到这里就换回ls -R了。要让 tree 真正跑起来并跑得好看得依次解决三件事安装文件从哪来、参数怎么配才不炸屏、装上之后那些反直觉的行为怎么绕。这篇顺着安装、验证、参数、流程、排查走一遍适合要把目录结构讲清楚、交出去或者接回来的人。2. 四种安装路径的取舍包管理器、源码编译与离线部署装 tree 这件事本身只有十几秒但选错路径会在后面持续还债。同一台机器上同时存在/usr/bin/tree和/usr/local/bin/tree、脚本里写死的 tree 版本在不同机器上行为不一致、内网机器连包都装不上这些都是选型阶段留下的。下面三种路径覆盖绝大多数场景选之前先想清楚这台机器是长期维护的还是有一次性任务。2.1 包管理器安装先刷新索引再落命令包管理器是默认选项代价是版本通常落后上游一两个小版本好处是升级、卸载、依赖关系都由系统统一管。不同包管理器的命令差异不大坑主要在“装之前有没有刷新索引”。包管理器刷新索引安装命令备注aptsudo apt updatesudo apt install -y tree不刷新时可能拿不到最新候选版本dnf默认按缓存过期策略自动刷sudo dnf install -y tree老版本可加--refresh强制刷yumsudo yum makecachesudo yum install -y tree元数据过期时会报包不存在pacman跟随-Syu整体升级sudo pacman -S tree不建议单独-Sy后装单包zyppersudo zypper refreshsudo zypper install -y tree企业环境常见apksudo apk updatesudo apk add tree容器镜像里最常见# 先看仓库里到底有没有、候选版本是多少避免盲装 sudo apt-cache policy tree # 装完立刻验证别等到写脚本那天才发现没装上 command -v tree tree --versionapt-cache policy会同时打印“已安装版本”和“候选版本”两行如果已安装版本比候选低说明系统里装的是旧包或者来自别的源。验证用的是command -v而不是which因为which在不同 shell 下的行为并不统一有的发行版里它甚至是独立包而command -v是 shell 内建能准确告诉你当前环境实际会执行哪个可执行文件。想看得更全就用type -a tree它会把 PATH 上所有同名可执行文件按优先级列出来排查“装了两份”时非常省事。-y的作用是跳过交互确认写进自动化脚本时必须加手工装的时候加不加都行但加了之后如果包名拼错命令会直接失败而不是停在确认提示上反而更容易发现错误。2.2 源码编译安装仓库版本不够用时的兜底手段需要走源码编译的情形就三种目标系统的仓库版本太老、目标系统根本没有包管理器精简容器镜像、定制镜像、需要指定安装前缀把 tree 装到非标准路径。除此之外没必要自找麻烦编译出来的二进制不归包管理器管后续升级得自己记着。# 构建工具链先备齐缺 gcc 的时候 configure 会在检测阶段直接退出 sudo apt install -y build-essential # 拿到源码包后先解压别在原目录里直接 configure tar -xzf tree-*.tar.gz cd tree-*/ # 指定安装前缀避免和包管理器装的版本互相覆盖 ./configure --prefix/usr/local # 用满核编译然后安装 make -j$(nproc) sudo make install # 清掉 shell 的命令路径缓存否则可能还在执行旧的那份 hash -r command -v tree tree --version--prefix/usr/local的效果是二进制落到/usr/local/bin/treeman page 落到/usr/local/share/man/man1/。PATH 的默认顺序里/usr/local/bin通常排在/usr/bin前面所以装完之后命令会优先命中新版本但如果你的环境改过 PATH就可能出现“装完了但还是老版本”的情况这时候用type -a tree一眼就能看出来。make install支持DESTDIR做打包或者先装到临时目录再挪走时用它make DESTDIR/tmp/tree-pkg install产物全部落在/tmp/tree-pkg下不会污染系统目录。注意源码编译时如果系统缺 gettext 相关组件configure可能自动关掉本地化支持表现是英文提示正常但其他语言的提示变成英文原文不影响功能。想要确定行为一致可以在configure阶段显式加--disable-nls把结果固定下来。编译完的二进制依赖系统的 C 库版本这一点决定了它能不能直接拷到别的机器上用下一节会细说。2.3 离线安装把安装文件和校验一起带过去内网机器、隔离环境、批量部署这三类场景下最省事的做法不是现场编译而是在一台同架构、同大版本的系统上把安装包拉齐连同校验文件一起拷过去。# 在联网机器上准备目录并拉包 mkdir -p ~/offline/tree cd ~/offline/tree apt-get download tree # 生成校验文件和安装包放在一起 sha256sum tree_*.deb SHA256SUMS ls -l# 目标机器上先校验校验不通过就别装了 sha256sum -c SHA256SUMS sudo dpkg -i tree_*_amd64.deb # 如果报依赖缺失用这一条补齐 sudo apt install -fRPM 系的做法对应过来是dnf download --destdir ~/offline/tree tree需要装dnf-plugins-core目标机用sudo dnf install ./tree-*.rpm本地安装这样依赖关系仍然由 dnf 解析比直接rpm -ivh稳妥。还有一种看起来更省事的办法直接从一台机器把编译好的二进制拷到另一台。这招在两边大版本一致时能用跨大版本就经常翻车报错通常是GLIBC_2.xx not found因为二进制链接的是构建机器的 C 库符号版本。真要这么干先在目标机上用ldd看依赖或者干脆在构建时加静态链接编译但静态链接不是 tree 的官方默认产物成功率取决于工具链别把它当标准方案。提示离线装完之后同样要跑一次command -v tree tree --version因为dpkg -i和rpm -ivh在部分情况下会成功解包但留下未配置状态表现是文件在系统里、命令却不可用。3. 让 tree 的输出可读可控深度、过滤、字段与排序四组参数tree 的默认行为是“把能展开的全展开”。在一个正常规模的项目目录里这个默认值等于灾难终端刷屏几十屏往上翻找不到根节点重定向到文件能写出几百兆。真正用得顺手的配置基本都围绕四组参数做组合限制深度、过滤路径、控制显示字段、固定排序。这四组之间还有优先级关系配错了会出现“明明写了过滤却没生效”的情况。3.1-L与--filelimit控制展开深度的两个旋钮-L限制的是层数从当前目录往下数-L 1只列顶层-L 2列到第二层。它是最有效的一刀绝大多数场景-L 2或-L 3就够看完结构。# 只看两层目录排在文件前面同时排掉常见的构建产物 tree -L 2 --dirsfirst -I node_modules|dist|.git|__pycache__ . # 某个目录下零散文件太多用 --filelimit 挡住不展开 tree -L 3 --filelimit 50 /path/to/project--filelimit 50的含义是某个目录下条目数超过 50 就不展开它的子项输出里会显示一行[50 entries exceeds filelimit, not opening dir]。这个选项在遍历日志目录、缓存目录时特别有用因为那些目录动辄几万个文件展开一次要等好几秒而你需要的信息其实只是“这里文件很多”。两个参数的分工要分清-L管的是纵向层数--filelimit管的是横向宽度。实际使用中先上-L砍掉深层无关结构再上--filelimit挡住宽目录两步下来输出规模基本可控。3.2-I与-P过滤模式串的匹配规则-I是排除-P是只保留两者都接受以|分隔的多个模式串。模式串支持 shell 通配符*、?、[]不是正则表达式写成.*\.log这种正则语法是无效的。# 排除多个模式用 | 分隔整体用单引号包住防止 shell 提前展开 tree -L 3 -I node_modules|.git|dist|build|*.log|*.tmp . # 只保留只看源码和配置文件 tree -L 3 -P *.py|*.toml|*.cfg|*.md .引号必须加。不加引号时如果当前目录下恰好有匹配*.log的文件shell 会先把*.log展开成具体的文件名列表再传给 tree结果是排除规则完全失效。这是过滤不生效最常见的原因没有之一。-P的行为和-I有个容易混淆的差别-P是“只打印匹配的”但它的匹配对象是文件名目录名的匹配行为在部分版本上受--matchdirs影响。如果只想保留特定扩展名的文件却仍然希望看到完整目录骨架加上--matchdirs让目录也参与匹配或者干脆用-I反向排除。--prune是配合过滤使用的收尾选项被过滤掉之后变成空的目录直接剪掉不显示。加了它输出里就不会出现一堆只有目录名、下面什么都没有的“光杆”。# 过滤之后把空目录也剪掉输出更干净 tree -L 3 -I node_modules|.git|dist --prune .3.3-a、-d、-f与体积字段决定输出里出现什么显示字段这组参数决定每条记录带哪些信息配的时候要看输出最终给谁看。-a显示以点开头的隐藏文件与目录。不加这个参数时.env、.editorconfig这类文件不会出现做配置审查时容易漏看但加了之后.git目录下的内容会铺开一大片所以通常要配合-I .git一起用。-d只列目录文件全部不显示。做目录结构梳理、检查有没有多余的中间层时用它输出量能降一个数量级。-f给每一项加上从当前目录起的完整相对路径。这个选项在需要把输出交给别的脚本处理时很有用因为每一项都是可以直接使用的路径不用再拼前缀。体积相关的有两个-s显示每个文件的字节数-h把大小转成人类可读形式K、M、G--du则是把目录下所有子项的体积累加到目录本身上。# 只看两层目录按累加体积显示先定位吃空间的大户 tree --du -h -L 2 -d /srv/data # 看文件级大小去掉 -d 才有意义 tree -h -s -L 2 /srv/data-h单独用不会显示大小它只是“把大小格式化”得和-s或--du搭配才有效果。这个组合关系文档里写得不算显眼新手很容易只写-h然后纳闷为什么没有数字。还有两个和终端相关的-C强制开启彩色输出管道重定向时默认是关闭的需要干净的纯文本就用--noreport去掉末尾那一行“X directories, Y files”的统计。3.4--sort与--dirsfirst排序影响的是结果稳定性默认按字母序排列。在把 tree 输出纳入版本控制、或者用diff比对前后两次结果时排序必须是确定的否则会出现“内容没变但 diff 一片红”的假告警。--sort支持几个取值name默认、size、mtime、ctime、version。--dirsfirst把目录整体排在文件前面视觉上更像结构图。-r反转顺序-t等价于按修改时间排序-v是按版本号的自然排序v2排在v10前面而不是后面。# 目录优先 按名字排序适合生成给人看的结构文档 tree -L 3 --dirsfirst --sortname . # 按修改时间倒序最近改过的排最前 tree -L 2 -t -r .注意--sortsize和--du一起用时排序结果未必和你预期一致。目录的累加体积是在遍历过程中逐步算出来的排序时读到的是“当时已知的大小”大目录不一定排在最前面。要按体积排名用du -sh */ | sort -h交叉验证一次更稳。4. 把 tree 接进实际流程结构文档、磁盘盘点与 JSON 管道单独敲一条 tree 谁都会真正产生价值的是把它固定成流程里的一个环节仓库根目录放一份随代码更新的结构说明、服务器上定期用 tree 盘一次磁盘、把输出转成结构化数据喂给后续统计。这三种用法对参数的要求完全不同下面分开写。4.1 生成可提交的项目结构文档项目交接、README 补充目录说明、新成员入职都需要一份固定的结构快照。做法是把 tree 输出直接写进文件但输出内容必须是不依赖终端环境、可重复的。cd /path/to/project # -o 直接写文件--noreport 去掉末尾统计行--dirsfirst 保证目录在前 tree -L 3 --dirsfirst --sortname --noreport \ -I .git|node_modules|dist|build|.venv|__pycache__|*.pyc|*.log \ -o /tmp/STRUCTURE.txt . # 写完之后再挪进来避开一个经典的自我包含问题 mv /tmp/STRUCTURE.txt ./STRUCTURE.txt先写/tmp再挪回来是为绕开一个高频坑-o指定的文件会在遍历开始前就被创建如果它落在被遍历的目录里输出里就会出现一行指向它自己的记录而且每次重新生成都会带上上一次的记录越滚越大。这个细节在第 5 章还会展开。--noreport去掉的那行X directories, Y files看着无害但它会让每次生成的文件末尾跟着变放进版本控制后只要文件数一变就产生 diff。如果确实想在文档里体现规模单独用一条命令统计后手写进去更可控。生成的文件建议只在结构调整时更新不要挂进每次构建的流程。目录文档的价值在于它稳定、能追溯变化天天变的文档没人看。4.2 用--du做一次快速的磁盘盘点服务器上磁盘告警第一反应是du -sh *逐层往下钻路径深的时候要敲很多次。tree 的--du可以一次性把两三层的体积铺开适合先做粗定位。# 两层目录 累加体积一眼定位占用最大的分支 tree --du -h -L 2 -d /srv/data # 需要往下再看一层时只改 L 的值其他参数不动 tree --du -h -L 3 -d /srv/data/app-d在这里是必需的否则每个文件的体积都会打出来输出量翻几十倍还没什么用。--du给出的目录体积是该目录下所有内容的总和包含子目录这一点和du -sh一致。--filelimit在这里可以再叠一层体积大的目录往往文件数也多加一个--filelimit 200能避免某个缓存目录把整次遍历拖慢。这条命令适合写进巡检脚本把输出按周存档磁盘增长的趋势比单次快照更有价值。# 每天打一份快照文件名带日期 tree --du -h -L 2 -d --filelimit 200 /srv/data \ /var/log/disk-tree/$(date %F).txt要注意的是 tree 遍历大目录时会真的去 stat 每个文件--du场景下 IO 压力不算小放在业务高峰期跑容易影响同机其他服务。安排在低峰期或者对超大目录单独用du处理。4.3-J输出 JSON接给 jq 做二次统计需要“统计有多少个文件、按扩展名分布、某个目录下最大的十个文件”这类问题时tree 的文本输出不适合解析。加-J直接输出 JSON结构是嵌套的对象树每个节点带type、name、size、mode字段目录节点有contents数组。# 统计文件总数 tree -J -L 3 -I .git|node_modules . | jq [.. | objects | select(.typefile)] | length # 按扩展名分组计数从多到少排列 tree -J -I .git|node_modules . \ | jq -r [.. | objects | select(.typefile) | .name | split(.) | last] | group_by(.) | map({ext: .[0], n: length}) | sort_by(-.n) | .[] | \(.n)\t\(.ext).. | objects是 jq 的递归下降写法能把嵌套结构里的所有对象拉平select(.typefile)过滤掉目录节点。第二段里split(.) | last取的是扩展名没有扩展名的文件会得到文件名本身统计时可以把这类单独归到“无扩展名”里。JSON 输出的一个限制是拿不到相对路径的完整形式只有name。需要完整路径就在 jq 里自己拼或者改用-f的文本模式加awk处理——哪种更顺手取决于后续要不要做字符级分析。-J也可以和-XXML互换但实际工作里 JSON 和 jq 的组合更常见XML 主要是在已有工具链需要的时候用。5. tree 用出问题时的排查五个反复出现的翻车现场装上了、参数也写了剩下的问题基本集中在几类可复现的翻车上。下面五条按“现象 → 原因 → 解决”来写都是配置里反复出现过的。5.1 包已经装了敲 tree 还是 command not found现象dpkg -l | grep tree或rpm -qa | grep tree能查到包ls /usr/local/bin/tree文件也在但直接敲tree提示找不到命令。原因/usr/local/bin不在当前 shell 的 PATH 里或者 shell 的命令路径缓存里还留着“这个命令不存在”的旧记录。前一种在 sudo 环境、systemd 服务、cron 任务里特别常见因为这些环境的 PATH 和交互式登录 shell 并不相同后一种发生在刚make install完还开着旧终端的情况下。解决先用echo $PATH和type -a tree确认。PATH 缺目录就写进~/.profile或对应服务的环境配置里缓存问题用hash -r清掉。排查服务类问题时直接写绝对路径/usr/local/bin/tree是最快的验证方式能跑通就说明是 PATH 的事不用继续查。5.2 重定向出来的文件把自己也列了进去现象执行tree -L 3 . STRUCTURE.txt之后再打开STRUCTURE.txt里面有一行STRUCTURE.txt而且下次重新生成时这一行还在内容层层叠加。原因shell 在命令执行前就创建并打开重定向目标文件tree 开始遍历时这个文件已经存在于目录里了。解决三种写法都行。-o写到目录外再 mv 回来用-I STRUCTURE.txt显式排除或者用tree ... | tee STRUCTURE.txt时先写临时文件。团队里统一成第一种最省心因为不依赖维护排除列表。5.3 大目录把终端和硬盘一起拖死现象在/var/log或某个缓存目录下执行tree终端卡住十几秒然后刷出几十万行中途 CtrlC 也停不干净重定向到文件的场景下文件能写到几个 G。原因默认没有深度限制和条目限制tree 会真的遍历所有子目录并 stat 每个文件。加上-l跟随符号链接时如果目录里存在指向上级目录的链接还可能触发环路检测输出里出现大量recursion detected。解决养成默认带-L的习惯tree -L 2作为起手式。已经确认是宽目录的叠--filelimit 200。需要跟符号链接的场景必须同时给-L限制层数别让它在链接里无限展开。跑之前先df -h看一眼磁盘余量避免重定向把分区写满。5.4-I写了但过滤不掉现象命令里明明写了-I *.log输出里还是出现了.log文件或者-I node_modules|.git只过滤掉了其中一个。原因三个可能。第一模式串外层没加引号被 shell 提前展开成了具体文件名第二写成了正则语法比如.*\.log而 tree 只认通配符第三-P和-I同时存在时两者的匹配顺序和交互和你以为的不一样。解决模式串一律用单引号包住通配符只写*、?、[]不要写\.和.*同时用-P和-I时先只留一个验证确认单个规则生效了再叠加。验证方法是拿一条最小的命令试tree -L 1 -I node_modules .能过滤再加规则。5.5 中文目录名和特殊字符显示成八进制转义现象本该显示中文名的位置出现了\344\270\255\346\226\207这样的序列或者空格、引号被转义成\040、\。原因tree 默认会把不可打印字符和非 ASCII 字符按八进制转义输出这是为了保证输出在不同终端和管道下都能安全解析。终端的 locale 设置也会影响判断LANGC环境下更容易触发。解决加-N--nolinks之外的非转义选项让非打印字符原样输出。同时把LANG和LC_ALL设成 UTF-8 编码export LANGen_US.UTF-8这一类。如果是把输出交给别的程序处理反过来建议保留转义因为带空格的文件名在后续解析时更容易出错。6. 用--fromfile做清单重建与结构比对一个能沉淀下来的小技巧前面所有用法都建立在“tree 能直接访问那个目录”的前提上。但现实里经常遇到拿不到目录的情况目标机器只允许你导出文件列表、跨环境迁移时不想同步几百 G 的文件、想比对两台机器上的目录结构是否一致。tree 的--fromfile就是为这种场景准备的它不从文件系统读而是从标准输入读一份路径清单按清单把树画出来。# 在远端只导出路径清单不碰文件内容 find /srv/app -maxdepth 4 -not -path */.git/* | sort manifest.txt # 本地按清单重建结构完全不访问原始目录 tree --fromfile manifest.txt清单里每行是一个路径用/分隔层级tree 会自动把它们拼成一棵树。--fromfile下-L依然有效可以在重建时再裁一次层数-I也能用用来把清单里不想看的路径挡掉。这个能力在结构比对里更有价值。两次发布之间目录结构有没有变用清单重建后直接diff即可# 改动前存一份 find /srv/app -maxdepth 3 | sort before.txt tree --fromfile before.txt before.tree # 发布之后再存一份 find /srv/app -maxdepth 3 | sort after.txt tree --fromfile after.txt after.tree # 只看结构差异忽略内容 diff before.tree after.tree--fromfile有一个必须注意的边界清单里的路径必须是真实存在的层级的“前缀形式”如果只给了a/b/c而没给a和a/btree 仍然能画出完整路径但当清单里出现同名前缀冲突时结果会以先出现的为准。所以生成清单时用find加sort排序能保证父路径先于子路径出现重建结果才稳定。这个技巧我在几个项目里固定下来了发布脚本里跑一次结构快照存档到版本目录里出问题时第一件事就是拉出上一次的快照做diff比翻部署日志快得多。真正吃过亏的地方不是命令本身而是清单里混进了临时文件路径——排掉它们要么在find阶段就过滤要么在--fromfile后面用-I再挡一层两层都做最保险。希望帮到你。本文还有配套的精品资源点击获取