简介：面向 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 包管理器安装：先刷新索引再落命令

包管理器是默认选项，代价是版本通常落后上游一两个小版本，好处是升级、卸载、依赖关系都由系统统一管。不同包管理器的命令差异不大，坑主要在“装之前有没有刷新索引”。

# 先看仓库里到底有没有、候选版本是多少，避免盲装 sudo apt-cache policy tree # 装完立刻验证，别等到写脚本那天才发现没装上 command -v tree tree --version

apt-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/tree，man 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 -f

RPM 系的做法对应过来是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 --sort=name . # 按修改时间倒序，最近改过的排最前 tree -L 2 -t -r .

注意：--sort=size和--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 --sort=name --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(.type=="file")] | length' # 按扩展名分组计数，从多到少排列 tree -J -I '.git|node_modules' . \ | jq -r '[.. | objects | select(.type=="file") | .name | split(".") | last] | group_by(.) | map({ext: .[0], n: length}) | sort_by(-.n) | .[] | "\(.n)\t\(.ext)"'

.. | objects是 jq 的递归下降写法，能把嵌套结构里的所有对象拉平；select(.type=="file")过滤掉目录节点。第二段里split(".") | last取的是扩展名，没有扩展名的文件会得到文件名本身，统计时可以把这类单独归到“无扩展名”里。

JSON 输出的一个限制是拿不到相对路径的完整形式，只有name。需要完整路径就在 jq 里自己拼，或者改用-f的文本模式加awk处理——哪种更顺手取决于后续要不要做字符级分析。

-J也可以和-X（XML）互换，但实际工作里 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，终端卡住十几秒，然后刷出几十万行，中途 Ctrl+C 也停不干净；重定向到文件的场景下，文件能写到几个 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 设置也会影响判断，LANG=C环境下更容易触发。

解决：加-N（--nolinks之外的非转义选项）让非打印字符原样输出。同时把LANG和LC_ALL设成 UTF-8 编码，export LANG=en_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/b，tree 仍然能画出完整路径，但当清单里出现同名前缀冲突时，结果会以先出现的为准。所以生成清单时用find加sort排序，能保证父路径先于子路径出现，重建结果才稳定。

这个技巧我在几个项目里固定下来了：发布脚本里跑一次结构快照，存档到版本目录里，出问题时第一件事就是拉出上一次的快照做diff，比翻部署日志快得多。真正吃过亏的地方不是命令本身，而是清单里混进了临时文件路径——排掉它们要么在find阶段就过滤，要么在--fromfile后面用-I再挡一层，两层都做最保险。希望帮到你。

本文还有配套的精品资源，点击获取