简介Linux 环境下的 tree 命令能以树状结构展示目录层级生成深度缩进的清晰文件列表是排查目录结构或梳理项目文件时的常用小工具。这份配套资源面向需要安装 tree 的 Linux 用户集中提供 tree-1.7.0 源码包与简明安装说明可帮助在 CentOS 等发行版中快速完成从解压、编译到启用的整个过程。压缩包共 19 个文件大小仅 57KB包含 8 个 C 源码文件及配套头文件并带有构建脚本、Readme 说明、许可证、变更记录与待办清单等典型的开源项目配套文件既有可编译运行的完整代码也保留了便于按需查阅的安装与使用说明。已有 4484 人学习此资源适合刚接触 Linux 命令行的新手也适合需要离线部署或了解命令实现原理的运维与开发人员。通过该资源读者既能获得 tree 命令的安装入口也能对照源码理解目录树的递归遍历与输出控制逻辑为后续自行编译和定制 Linux 小工具打下基础。1. 目录树命令怎么看也不像需要单独一篇安装说明很多同事一开始把 Linux tree 命令当成 ls 的高级替代输入 tree屏幕上哗啦长出一棵目录树看几眼就关了。真正用到它的时候往往是新装的服务器或者刚拉下来的容器镜像里命令行回你一句 tree: command not found。这时你才发现安装 tree 也得找对安装文件、避开编译环境的依赖问题、还要处理输出里的转义坑。下面的内容就顺着安装文件和完整使用说明展开先把 apt/yum 两条路讲清楚再给源码编译的最小步骤最后交代几个高频使用细节。适合刚上手 Linux 的新手照着做也适合写自动化脚本的熟手回来纠错。2. tree 命令能干什么从目录树原理到高频输出参数2.1 目录树的逻辑tree 和 find 的本质差异先解决一个观念问题tree 不是 find 的花哨皮肤。find 的设计目标是“在一堆路径里按条件找出文件”它默认输出的是一行一个路径的扁平结果后续可以用 xargs、grep 继续加工。tree 的设计目标是“把目录层级画出来给人看”它默认输出的是带树形符号的层次视图信息密度和阅读顺序完全不一样。举一个真实差异的例子。排查/etc下有哪些配置文件时find 能把所有文件路径列得明明白白# 找 /etc 下两层以内的所有普通文件 find /etc -maxdepth 2 -type f | head -n 20得到的是纯路径列表适合交给管道继续处理。但如果想快速确认/etc目录的整体结构find 的输出就太散了tree 两行命令更直接# 同样只看两层但画成树 tree -L 2 /etc | head -n 20这个对比说明两者信息源相同但表达方式决定了使用场景。脚本里批量操作优先用 find给人看的报告、文档里的目录结构截图、交付时生成的目录清单则习惯把 tree 的输出贴进去。从内部实现上讲tree 在 Linux 上走的是 readdir 递归遍历进入一个目录读取目录条目根据文件类型标记符号再对子目录重复这个过程。它读到的只是元数据不会打开每个文件去读内容所以正常目录下即使有几个超大文件tree 也不会慢到哪去真正拖慢它的是目录层级特别深、目录数量特别多的情况。tree 默认还不显示隐藏文件find 则会把以点开头的文件也列出来。不要拿 find 的结果数量去对 tree 的数量数量对不上不算 bug是两者过滤规则不同。做文件清单时要在 tree 后面加-a才会把隐藏文件算进来丢掉这一点最容易漏文件。还有一个容易忽略的点tree 的排序规则受语言环境影响。同一个目录在 LANGC 和 LANGzh_CN.UTF-8 下排序结果可能不同。做基线对比时先export LANGC再执行 tree得到的顺序才稳定这个习惯在后面的避坑章节还会用到。2.2 高频输出参数从 -L、-d 到 -P、--dirsfirst把 tree 用好其实不用背几十个参数先把下面这组高频参数吃透就够日常用了。按“先限范围、再改内容、最后调格式”的顺序整理参数作用常见组合-L n只递归 n 层目录tree -L 2 /opt-d只显示目录、不显示文件tree -d -L 3-a把隐藏文件也显示出来tree -a-f每行显示完整路径tree -f-P pattern只保留匹配模式的文件tree -P *.conf-I pattern排除匹配模式的文件tree -I node_modules--prune把不符合筛选的空目录剪掉tree --prune -P *.py--dirsfirst目录排前面文件排后面tree --dirsfirst--noreport不打印最后的统计数字tree --noreport这里要重点提醒的是-P和-I的模式匹配。它们接受的是通配符不是正则表达式而且多个模式用竖线分隔时必须加引号否则 shell 会把竖线当成管道符命令直接翻车。我一般这样写# 排除 node_modules 和 .git只看两层 tree -L 2 -I node_modules|.git注意-I的引号不能省。一旦漏掉shell 会把命令拆成tree -L 2 -I node_modules和.git两个部分去执行轻则报错重则把无关目录的清单也打出来。这是我在打包脚本里踩过的坑后来养成了所有模式参数一律加引号、写完先 echo 一遍再执行的硬习惯。再看一个组合把目录树变成文件清单。# 完整路径 隐藏文件 不显示统计信息 tree -a -f --noreport manifest.txt-f让每一行输出完整路径脚本不用再拼前缀--noreport去掉最后一行 “X directories, Y files” 的统计文件清单更干净。这个组合在交付代码目录、制作备份清单时非常实用。如果你只想看目录骨架不想被文件刷屏用-d。配合-L可以快速确认一个项目的目录结构# 只看目录两层 tree -d -L 2它和-a可以叠加变成“连隐藏目录一起显示”适合检查.git、.idea这类目录是不是被带进了项目。提示-P、-I筛选的是叶子条目筛选后父目录可能变成空目录但 tree 仍会显示它。想要让空目录从结果里消失加入--prune但--prune会和-a、-f产生一些交互组合前先看一遍输出再决定。2.3 输出标记与颜色树形符号、链接指向和 LS_COLORStree 显示的树形符号不只是“好看”它们是有信息量的├──表示还有后续兄弟节点└──表示当前是最后一项│是父子层级的纵向连线。看到这些符号边界感就出来了所以生成文档截图时我不改这些符号保持默认。符号链接在 tree 里默认显示成名称 - 目标的结构比如lib - usr/lib这一行说明 lib 是一个软链接指向后面的目标路径。新手容易误以为 tree 没有递归软链接目录是“漏了”其实这正是 tree 在防止循环引用遇到 A 链接到 B、B 又链接回 A 的目录结构时默认行为反而最安全。特殊文件会以方括号标注类型比如设备文件、socket、FIFO 管道tree 会在文件名后面加一个[类型]标记这是普通 ls 里看得更费劲的信息。做系统排查时我习惯先用 tree 扫一遍/dev目录能快速看出哪些异常设备节点混在里面。颜色默认由 LS_COLORS 环境变量控制终端里看着舒服但进入脚本就麻烦了。后面避坑章节会专门讲转义码污染文件的问题这里先说结论生成给人看的报告时用-C强制颜色生成给程序处理的结果时不要带任何颜色参数。更不要顺手在 shellrc 里给 tree 定义 alias 带上-C等到脚本输出乱掉再来找原因属于典型的自己坑自己。3. 安装文件从哪来包管理器安装和源码编译两条路3.1 apt/debian一行命令装完但要先过软件源这关Debian、Ubuntu 及其衍生发行版上tree 被收录在软件源里正常情况下一行命令就装完了# 先更新索引再安装 tree sudo apt-get update sudo apt-get install -y tree注意两条命令要连起来执行。很多人会跳过第一句直接 install结果提示E: Unable to locate package tree。这不是软件源里没有而是本地包索引是空的apt 根本不知道该去哪找安装文件。这一点在刚拉下来的容器镜像里尤其常见基础镜像为了精简连 apt 索引都不给你留。如果 update 之后仍然提示找不到包那就是软件源配置的问题。有些定制镜像故意只保留了少量软件源组件tree 不在默认组件里。检查一下/etc/apt/sources.list以及/etc/apt/sources.list.d/下的配置文件确认里面有没有启用完整组件改完再 update。不要急着去网上找 deb 包手动安装软件源依赖没对齐手动装反而会引发连锁问题。还有一种情况镜像里没有 sudo。容器里一般是 root直接 apt-get install 即可不需要 sudo但如果你在别人封装好的镜像里看到sudo: command not found就别硬套本地主机的命令直接把 sudo 去掉再试# 容器内是 root 用户时去掉 sudo apt-get update apt-get install -y tree安装完成后用一条命令验证which tree tree --version只要输出了路径和版本信息说明安装文件已经就位。也建议顺手执行一下tree /tmp确认动态库、终端输出都没有问题。3.2 yum/dnfCentOS、RHEL 系安装与 EPEL 的关系使用 yum 的 CentOS 7 和 RHEL 7以及使用 dnf 的 RHEL 8、9 和主流 Fedora 版本安装命令本身很简单# CentOS 7 系列 sudo yum install -y tree # RHEL 8/9、CentOS Stream 系列 sudo dnf install -y tree坑往往不在命令而在软件源。CentOS 7 的默认源里带 treeRHEL 8/9 的 AppStream 源在标准配置下也带但如果你的系统是自定义精简版本或者安装时选了最小化安装包软件源列表里可能没有 tree。最常见的出路是启用 EPEL 扩展源# 先安装 EPEL再安装 tree sudo dnf install -y epel-release sudo dnf install -y treeEPEL 里的 tree 和发行版自带源里的 tree 不会冲突安装器会自动选一个可用版本。这里有一个原则不要一遇到装不上就去搜索引擎找 rpm 下载地址。手动下载 rpm 再安装依赖关系经常是缺一个、装一个、再缺一个最后被迫--nodeps强装把环境搞脏。我见过不止一个开发环境最后 rpm 数据库一团乱都是从不必要的第三方 rpm 开始的。装完还是先验证which tree tree -L 1 /如果which tree有输出但 tree 执行时报错比如提示 libc 版本过低、找不到共享库说明系统太老或太精简。老系统上我会直接放弃二进制包走源码编译这条路对应下面 3.3 节的内容。yum 系还有一个潜在问题如果你之前手动把 tree 的二进制复制到/usr/bin里yum 安装时会报文件冲突。处理方式是先删掉手动放置的文件再执行安装命令。不用害怕这才是标准的解决问题顺序。3.3 源码编译拿到 tar.gz 形式的安装文件后怎么做标题里的“安装文件”最常见的形态就是源码包 tar.gz。有人是因为系统里找不到现成包才转源码也有人是为了看 tree 的实现故意自己编译。不管哪种动机源码编译安装的步骤都值得按“最小操作集”记下来。首先把安装文件放到一个临时目录解压# 假设离线环境下已经把源码包放到了 /opt/pkg cd /opt/pkg tar -xzf tree-*.tar.gz cd tree-*这里tree-*是通配实际目录名会像tree-2.x.x这样带着版本号具体以你拿到的安装文件为准不要死记命令里的目录名。解压后先别急着编译花十秒钟看一眼目录里的 README 和 Makefile这两个文件决定了后续步骤。tree 的源码包和很多大型 GNU 项目不一样它通常不提供 configure 脚本而是直接给 Makefile。所以不要去执行./configure那只会得到一条No such file or directory的报错。正确做法是直接 make# 编译-j4 表示用 4 个并行任务 make -j4 # 编译成功后安装默认装到 /usr/local sudo make installmake 做完之后当前目录里会多出 tree 可执行文件这时可以直接./tree看效果。make install 会把二进制安装到系统目录并把 man page 装到对应位置。如果要指定安装目录不要用常见的--prefix而是给 make 传 PREFIX 变量# 安装到用户目录不需要 sudo make PREFIX$HOME/toolbox install安装完成后的验证$HOME/toolbox/bin/tree --version这两点没有 configure、用 PREFIX是这个项目最容易翻车的地方。很多从源码装过 libevent、openssl 的人在这里会下意识执行./configure --prefix...结果全线崩溃 root 出这一点后续就顺了。还有一个常被忽略的做法用 DESTDIR 做打包。你可以在 A 机器上编译然后装到一个临时目录里再把整个临时目录拷到 B 机器用# 把安装文件生成到自定义目录而不是系统里 make install DESTDIR/tmp/tree-pkg这样不会污染当前系统适合批量交付场景。DESTDIR 不是每个命令行工具都支持但 tree 的 Makefile 一般会处理它值得一试。3.4 卸载与版本冲突别急着删源码目录源码安装之后最容易被忽略的是卸载。很多人装完之后顺手把源码目录删了等哪天想卸掉 tree才发现没有任何卸载脚本可跑最后手工去删/usr/local/bin/tree和 man page又怕删不干净。正确做法很朴素保留源码目录用 Makefile 自带的卸载目标# 在之前解压的 tree 源码目录里执行 sudo make uninstall如果当初用了 PREFIX卸载时要把 PREFIX 也写回来否则 make uninstall 不知道文件装在哪sudo make PREFIX$HOME/toolbox uninstall注意卸载完成后源码目录仍然可以留着或者确认不再需要后直接删除。但如果卸载前就把目录删了就只能用type -a tree手工定位全部文件再逐个清理。所以最简单的原则是没卸载之前不删源码目录。再讲版本冲突场景。如果你的系统里同时存在 apt 安装的 tree 和源码安装的 treewhich tree的查找结果由 PATH 决定。常见的排列顺序是/usr/local/bin在/usr/bin前面所以你执行 tree 时可能用的是源码版但 dpkg -l tree 查到的却是包管理器版两者版本不一样排查时特别绕。我自己的排查顺序是三步# 1. 看当前执行的是哪个文件 type -a tree # 2. 看两个常见路径下是否都有 tree ls -l /usr/local/bin/tree /usr/bin/tree 2/dev/null # 3. 确认哪个属于包管理器 dpkg -L tree 2/dev/null rpm -ql tree 2/dev/null这组命令不是每次都要跑但一旦遇到“版本怎么不对”“选项怎么没有”这种玄学问题多半是 PATH 里混进了两个 tree。先定位再动手比反复重装省事得多。多个 tree 并存不用慌把 PATH 顺序调对、把不需要的那个卸掉就好最忌讳的是直接删/usr/bin/tree因为包管理器数据库里还记着这个文件之后的升级、卸载都会报错。4. 避坑tree 安装和使用时最容易翻车的 5 个场景4.1 命令找不到装好了却提示 command not found现象用 apt 或 yum 装完 tree退出终端重进输入 tree 仍然提示command not found。部分场景下 sudo tree 能执行普通用户执行就找不到。原因tree 被安装到了/usr/local/bin而当前用户 PATH 里没有这个目录或者当前 shell 是无登录 shell没有加载/etc/profile里的 PATH 配置。还有一种是源码安装时指定了 PREFIX但没把对应 bin 目录加进 PATH。解决# 查看 tree 的真实路径 type -a tree ls -l /usr/local/bin/tree /usr/bin/tree 2/dev/null # 直接用完整路径测试 /usr/local/bin/tree --version如果完整路径能执行就在~/.bashrc里追加一行export PATH/usr/local/bin:$PATH保存后执行source ~/.bashrc再type tree验证。这不是什么高级操作但很多人第一反应是重新安装反复重装永远解决不了 PATH 问题。如果type -a显示路径已经正确而命令仍然失效再看一下是不是 shell 缓存执行hash -r清掉哈希缓存。4.2 源码编译失败缺编译器、缺基础头文件现象在精简系统上执行 make 编译 tree第一行就报gcc: command not found或者报fatal error: sys/types.h: No such file or directory。更常见的是连 make 都提示command not found。原因一个只装了运行环境的 Linux 不一定带编译工具链。源码安装需要编译器、make 命令、基础 C 库头文件这些在桌面发行版默认有但在容器、嵌入式设备、极小化服务器上往往是缺失的。解决先装齐编译工具再回去编译。Debian/Ubuntu 上执行sudo apt-get update sudo apt-get install -y build-essentialRHEL/CentOS 上执行sudo dnf groupinstall -y Development Tools sudo dnf install -y make gcc装完再回到源码目录make clean make -j4 sudo make install注意 make clean 这一步。第一次编译失败会在目录里留下大量.o目标文件和半成品不清理直接重新 make经常会报旧文件干扰。先make clean清掉再重新走一遍。这条经验是从血泪里抄出来的别想着“我只删其中一个 .o”就能省事直接 clean 才是最快路径。4.3 软链接目录不展开树看起来少了很多子目录现象执行tree -L 3 /opt发现有些目录显示成xxx - /var/xxx箭头之后没有任何下级目录数一数文件树比实际目录少了一半。原因tree 默认不会递归进入软链接指向的目录这是为了防止出现 A 链接到 B、B 又链接回 A 的循环引用。没有-l参数时它只把软链接本身当作一个特殊的叶子节点显示。解决确认你要展示的目录结构里没有循环风险并且确实需要跟随软链接显式加-ltree -lL 3 /opt这里-l和-L可以连着写成一个参数组。加了-l之后如果仍然觉得树不对劲检查你给的路径本身是不是软链接。tree 对命令行入参的处理和对树内部链接的处理不同直接执行ls -ld /opt看一眼目录属性再决定是跟/opt还是跟它指向的真实路径。跟踪软链接会放大输出量遇到一个指向大目录的链接一次输出可能几千行。不确定时先用-L 2控制一下规模确认无误后再放开层级。4.4 文件名带空格、换行生成的清单脚本没法读现象用tree filelist.txt生成了文件清单后面写 for 循环按行处理结果包含空格的文件名被拆成了两段统计结果少了文件。更极端的场景是文件名本身含换行直接把清单撑乱。原因tree 默认输出按换行分隔这种设计面向人肉阅读脚本里按行读取时空格、换行、特殊符号都会被当作分隔结构和 tree 的输出语义对不上。解决根据用途分两条路。人肉看直接用默认程序消费用 NUL 分隔或者结构化输出。tree 支持-0参数把条目用 NUL 字符分隔tree -0 files.txt在 bash 里配合 read -d 逐条处理while IFS read -r -d file; do echo got: $file done (tree -0)如果你的 tree 支持输出 JSON更推荐给复杂结构用 JSON让程序去解析不要自己正则拆行tree -J structure.json python3 -c import json,sys; datajson.load(open(structure.json)); print(top-level:, len(data))需要先确认帮助文档里有-J再这么做老版本没有这个选项。不管用-0还是-J核心原则是别用面向眼睛的默认输出去喂脚本那是拿黑匣子当接口用。4.5 重定向文件里出现颜色转义码diff 和 git 没法看现象执行tree -C out.txtcat 看起来正常但用 vim 或 git diff 查看时文件里全是[01;34m、[0m之类的颜色转义序列把差异比较结果弄得没法看。原因-C强制开启颜色。tree 在终端下默认就有颜色但一旦重定向它通常会自己关掉颜色一旦你显式加了-C或者 shell 环境里的 LS_COLORS 被某个版本强制继承重定向文件里就会被写入 ANSI 转义码。解决生成文件时不要加-C。如果脚本里用了某段复制过来的命令先检查里面有没有-C和--color有就删掉。清除环境变量也可以unset LS_COLORS tree --noreport clean.txt注意没有报错不代表输出干净。用cat -v clean.txt | head看一下有没有^[开头的字符那才是转义码的本相。如果确实需要保留颜色比如要把彩色树贴进终端能识别的文件里那是有意为之否则一律以无颜色输出为基础。这条规则同样适用于 tree 以外的所有 Linux 命令行工具。5. 两个把 tree 用出效率的实战技巧磁盘占用和基线比对这一章不是知识点的堆叠而是往前再走一步的用法。已经会安装、会看树之后下面两个技巧可以直接进工作流。第一个是目录占用审计。tree 本身不管文件内容但它支持--du会先统计目录内所有文件的体积再打印目录树配合-h可读性很好tree /var/log --du -h -L 2这个命令会同时展示目录层级和体积适合快速定位“哪个日志目录把磁盘吃光了”。但代价是它会遍历目录下所有子目录来统计大小在大目录上执行可能很慢建议加-L限定层级避免深层次目录被全部扫一遍。统计结果默认不包含以点开头的隐藏文件要精确结果就加-a还要留意它和du的块计算口径不完全一致不能直接画等号。第二个我实际用得多的是基线比对。发布新版本前后把项目目录的树结构分别导出再用 diff 比较能快速看出上线过程到底多了哪些文件、少了哪些目录。我的习惯命令是这样# 发布前生成基线 tree -a -f --noreport before.txt # 发布后再次生成 tree -a -f --noreport after.txt # 比较差异只看变化 diff before.txt after.txt加-f是为了让每一行都带完整路径diff 结果里直接能看到具体文件名。加--noreport是为了去掉统计行否则最后一行 “X directories, Y files” 必然不同diff 里永远多一条噪声。目录特别大时先输出到文件再 diff不要直接在管道里 diff避免两边 I/O 和缓冲互相干扰。比较出来的差异如果全是临时文件说明清理工作没做好如果多出了预期外的配置目录那就要再查一下发布脚本。这个思路也适用在使用 find 的场景但 tree 的可读性更适合做记录留存我一般会把这个输出直接提交到发布文档里下次回溯时一眼看到目录结构在哪个版本发生变化。最后说一个形成习惯的小细节导出 tree 清单之前先export LANGC避免中英文环境切换导致排序不一致diff 结果里出现大段假差异。有了这个习惯就不会被乱序问题骗到。希望这篇东西帮你在 Linux tree 命令的安装和日常使用上少踩几个坑把时间花在真正需要分析目录内容的地方。本文还有配套的精品资源点击获取
简介Linux 环境下的 tree 命令能以树状结构展示目录层级生成深度缩进的清晰文件列表是排查目录结构或梳理项目文件时的常用小工具。这份配套资源面向需要安装 tree 的 Linux 用户集中提供 tree-1.7.0 源码包与简明安装说明可帮助在 CentOS 等发行版中快速完成从解压、编译到启用的整个过程。压缩包共 19 个文件大小仅 57KB包含 8 个 C 源码文件及配套头文件并带有构建脚本、Readme 说明、许可证、变更记录与待办清单等典型的开源项目配套文件既有可编译运行的完整代码也保留了便于按需查阅的安装与使用说明。已有 4484 人学习此资源适合刚接触 Linux 命令行的新手也适合需要离线部署或了解命令实现原理的运维与开发人员。通过该资源读者既能获得 tree 命令的安装入口也能对照源码理解目录树的递归遍历与输出控制逻辑为后续自行编译和定制 Linux 小工具打下基础。1. 目录树命令怎么看也不像需要单独一篇安装说明很多同事一开始把 Linux tree 命令当成 ls 的高级替代输入 tree屏幕上哗啦长出一棵目录树看几眼就关了。真正用到它的时候往往是新装的服务器或者刚拉下来的容器镜像里命令行回你一句 tree: command not found。这时你才发现安装 tree 也得找对安装文件、避开编译环境的依赖问题、还要处理输出里的转义坑。下面的内容就顺着安装文件和完整使用说明展开先把 apt/yum 两条路讲清楚再给源码编译的最小步骤最后交代几个高频使用细节。适合刚上手 Linux 的新手照着做也适合写自动化脚本的熟手回来纠错。2. tree 命令能干什么从目录树原理到高频输出参数2.1 目录树的逻辑tree 和 find 的本质差异先解决一个观念问题tree 不是 find 的花哨皮肤。find 的设计目标是“在一堆路径里按条件找出文件”它默认输出的是一行一个路径的扁平结果后续可以用 xargs、grep 继续加工。tree 的设计目标是“把目录层级画出来给人看”它默认输出的是带树形符号的层次视图信息密度和阅读顺序完全不一样。举一个真实差异的例子。排查/etc下有哪些配置文件时find 能把所有文件路径列得明明白白# 找 /etc 下两层以内的所有普通文件 find /etc -maxdepth 2 -type f | head -n 20得到的是纯路径列表适合交给管道继续处理。但如果想快速确认/etc目录的整体结构find 的输出就太散了tree 两行命令更直接# 同样只看两层但画成树 tree -L 2 /etc | head -n 20这个对比说明两者信息源相同但表达方式决定了使用场景。脚本里批量操作优先用 find给人看的报告、文档里的目录结构截图、交付时生成的目录清单则习惯把 tree 的输出贴进去。从内部实现上讲tree 在 Linux 上走的是 readdir 递归遍历进入一个目录读取目录条目根据文件类型标记符号再对子目录重复这个过程。它读到的只是元数据不会打开每个文件去读内容所以正常目录下即使有几个超大文件tree 也不会慢到哪去真正拖慢它的是目录层级特别深、目录数量特别多的情况。tree 默认还不显示隐藏文件find 则会把以点开头的文件也列出来。不要拿 find 的结果数量去对 tree 的数量数量对不上不算 bug是两者过滤规则不同。做文件清单时要在 tree 后面加-a才会把隐藏文件算进来丢掉这一点最容易漏文件。还有一个容易忽略的点tree 的排序规则受语言环境影响。同一个目录在 LANGC 和 LANGzh_CN.UTF-8 下排序结果可能不同。做基线对比时先export LANGC再执行 tree得到的顺序才稳定这个习惯在后面的避坑章节还会用到。2.2 高频输出参数从 -L、-d 到 -P、--dirsfirst把 tree 用好其实不用背几十个参数先把下面这组高频参数吃透就够日常用了。按“先限范围、再改内容、最后调格式”的顺序整理参数作用常见组合-L n只递归 n 层目录tree -L 2 /opt-d只显示目录、不显示文件tree -d -L 3-a把隐藏文件也显示出来tree -a-f每行显示完整路径tree -f-P pattern只保留匹配模式的文件tree -P *.conf-I pattern排除匹配模式的文件tree -I node_modules--prune把不符合筛选的空目录剪掉tree --prune -P *.py--dirsfirst目录排前面文件排后面tree --dirsfirst--noreport不打印最后的统计数字tree --noreport这里要重点提醒的是-P和-I的模式匹配。它们接受的是通配符不是正则表达式而且多个模式用竖线分隔时必须加引号否则 shell 会把竖线当成管道符命令直接翻车。我一般这样写# 排除 node_modules 和 .git只看两层 tree -L 2 -I node_modules|.git注意-I的引号不能省。一旦漏掉shell 会把命令拆成tree -L 2 -I node_modules和.git两个部分去执行轻则报错重则把无关目录的清单也打出来。这是我在打包脚本里踩过的坑后来养成了所有模式参数一律加引号、写完先 echo 一遍再执行的硬习惯。再看一个组合把目录树变成文件清单。# 完整路径 隐藏文件 不显示统计信息 tree -a -f --noreport manifest.txt-f让每一行输出完整路径脚本不用再拼前缀--noreport去掉最后一行 “X directories, Y files” 的统计文件清单更干净。这个组合在交付代码目录、制作备份清单时非常实用。如果你只想看目录骨架不想被文件刷屏用-d。配合-L可以快速确认一个项目的目录结构# 只看目录两层 tree -d -L 2它和-a可以叠加变成“连隐藏目录一起显示”适合检查.git、.idea这类目录是不是被带进了项目。提示-P、-I筛选的是叶子条目筛选后父目录可能变成空目录但 tree 仍会显示它。想要让空目录从结果里消失加入--prune但--prune会和-a、-f产生一些交互组合前先看一遍输出再决定。2.3 输出标记与颜色树形符号、链接指向和 LS_COLORStree 显示的树形符号不只是“好看”它们是有信息量的├──表示还有后续兄弟节点└──表示当前是最后一项│是父子层级的纵向连线。看到这些符号边界感就出来了所以生成文档截图时我不改这些符号保持默认。符号链接在 tree 里默认显示成名称 - 目标的结构比如lib - usr/lib这一行说明 lib 是一个软链接指向后面的目标路径。新手容易误以为 tree 没有递归软链接目录是“漏了”其实这正是 tree 在防止循环引用遇到 A 链接到 B、B 又链接回 A 的目录结构时默认行为反而最安全。特殊文件会以方括号标注类型比如设备文件、socket、FIFO 管道tree 会在文件名后面加一个[类型]标记这是普通 ls 里看得更费劲的信息。做系统排查时我习惯先用 tree 扫一遍/dev目录能快速看出哪些异常设备节点混在里面。颜色默认由 LS_COLORS 环境变量控制终端里看着舒服但进入脚本就麻烦了。后面避坑章节会专门讲转义码污染文件的问题这里先说结论生成给人看的报告时用-C强制颜色生成给程序处理的结果时不要带任何颜色参数。更不要顺手在 shellrc 里给 tree 定义 alias 带上-C等到脚本输出乱掉再来找原因属于典型的自己坑自己。3. 安装文件从哪来包管理器安装和源码编译两条路3.1 apt/debian一行命令装完但要先过软件源这关Debian、Ubuntu 及其衍生发行版上tree 被收录在软件源里正常情况下一行命令就装完了# 先更新索引再安装 tree sudo apt-get update sudo apt-get install -y tree注意两条命令要连起来执行。很多人会跳过第一句直接 install结果提示E: Unable to locate package tree。这不是软件源里没有而是本地包索引是空的apt 根本不知道该去哪找安装文件。这一点在刚拉下来的容器镜像里尤其常见基础镜像为了精简连 apt 索引都不给你留。如果 update 之后仍然提示找不到包那就是软件源配置的问题。有些定制镜像故意只保留了少量软件源组件tree 不在默认组件里。检查一下/etc/apt/sources.list以及/etc/apt/sources.list.d/下的配置文件确认里面有没有启用完整组件改完再 update。不要急着去网上找 deb 包手动安装软件源依赖没对齐手动装反而会引发连锁问题。还有一种情况镜像里没有 sudo。容器里一般是 root直接 apt-get install 即可不需要 sudo但如果你在别人封装好的镜像里看到sudo: command not found就别硬套本地主机的命令直接把 sudo 去掉再试# 容器内是 root 用户时去掉 sudo apt-get update apt-get install -y tree安装完成后用一条命令验证which tree tree --version只要输出了路径和版本信息说明安装文件已经就位。也建议顺手执行一下tree /tmp确认动态库、终端输出都没有问题。3.2 yum/dnfCentOS、RHEL 系安装与 EPEL 的关系使用 yum 的 CentOS 7 和 RHEL 7以及使用 dnf 的 RHEL 8、9 和主流 Fedora 版本安装命令本身很简单# CentOS 7 系列 sudo yum install -y tree # RHEL 8/9、CentOS Stream 系列 sudo dnf install -y tree坑往往不在命令而在软件源。CentOS 7 的默认源里带 treeRHEL 8/9 的 AppStream 源在标准配置下也带但如果你的系统是自定义精简版本或者安装时选了最小化安装包软件源列表里可能没有 tree。最常见的出路是启用 EPEL 扩展源# 先安装 EPEL再安装 tree sudo dnf install -y epel-release sudo dnf install -y treeEPEL 里的 tree 和发行版自带源里的 tree 不会冲突安装器会自动选一个可用版本。这里有一个原则不要一遇到装不上就去搜索引擎找 rpm 下载地址。手动下载 rpm 再安装依赖关系经常是缺一个、装一个、再缺一个最后被迫--nodeps强装把环境搞脏。我见过不止一个开发环境最后 rpm 数据库一团乱都是从不必要的第三方 rpm 开始的。装完还是先验证which tree tree -L 1 /如果which tree有输出但 tree 执行时报错比如提示 libc 版本过低、找不到共享库说明系统太老或太精简。老系统上我会直接放弃二进制包走源码编译这条路对应下面 3.3 节的内容。yum 系还有一个潜在问题如果你之前手动把 tree 的二进制复制到/usr/bin里yum 安装时会报文件冲突。处理方式是先删掉手动放置的文件再执行安装命令。不用害怕这才是标准的解决问题顺序。3.3 源码编译拿到 tar.gz 形式的安装文件后怎么做标题里的“安装文件”最常见的形态就是源码包 tar.gz。有人是因为系统里找不到现成包才转源码也有人是为了看 tree 的实现故意自己编译。不管哪种动机源码编译安装的步骤都值得按“最小操作集”记下来。首先把安装文件放到一个临时目录解压# 假设离线环境下已经把源码包放到了 /opt/pkg cd /opt/pkg tar -xzf tree-*.tar.gz cd tree-*这里tree-*是通配实际目录名会像tree-2.x.x这样带着版本号具体以你拿到的安装文件为准不要死记命令里的目录名。解压后先别急着编译花十秒钟看一眼目录里的 README 和 Makefile这两个文件决定了后续步骤。tree 的源码包和很多大型 GNU 项目不一样它通常不提供 configure 脚本而是直接给 Makefile。所以不要去执行./configure那只会得到一条No such file or directory的报错。正确做法是直接 make# 编译-j4 表示用 4 个并行任务 make -j4 # 编译成功后安装默认装到 /usr/local sudo make installmake 做完之后当前目录里会多出 tree 可执行文件这时可以直接./tree看效果。make install 会把二进制安装到系统目录并把 man page 装到对应位置。如果要指定安装目录不要用常见的--prefix而是给 make 传 PREFIX 变量# 安装到用户目录不需要 sudo make PREFIX$HOME/toolbox install安装完成后的验证$HOME/toolbox/bin/tree --version这两点没有 configure、用 PREFIX是这个项目最容易翻车的地方。很多从源码装过 libevent、openssl 的人在这里会下意识执行./configure --prefix...结果全线崩溃 root 出这一点后续就顺了。还有一个常被忽略的做法用 DESTDIR 做打包。你可以在 A 机器上编译然后装到一个临时目录里再把整个临时目录拷到 B 机器用# 把安装文件生成到自定义目录而不是系统里 make install DESTDIR/tmp/tree-pkg这样不会污染当前系统适合批量交付场景。DESTDIR 不是每个命令行工具都支持但 tree 的 Makefile 一般会处理它值得一试。3.4 卸载与版本冲突别急着删源码目录源码安装之后最容易被忽略的是卸载。很多人装完之后顺手把源码目录删了等哪天想卸掉 tree才发现没有任何卸载脚本可跑最后手工去删/usr/local/bin/tree和 man page又怕删不干净。正确做法很朴素保留源码目录用 Makefile 自带的卸载目标# 在之前解压的 tree 源码目录里执行 sudo make uninstall如果当初用了 PREFIX卸载时要把 PREFIX 也写回来否则 make uninstall 不知道文件装在哪sudo make PREFIX$HOME/toolbox uninstall注意卸载完成后源码目录仍然可以留着或者确认不再需要后直接删除。但如果卸载前就把目录删了就只能用type -a tree手工定位全部文件再逐个清理。所以最简单的原则是没卸载之前不删源码目录。再讲版本冲突场景。如果你的系统里同时存在 apt 安装的 tree 和源码安装的 treewhich tree的查找结果由 PATH 决定。常见的排列顺序是/usr/local/bin在/usr/bin前面所以你执行 tree 时可能用的是源码版但 dpkg -l tree 查到的却是包管理器版两者版本不一样排查时特别绕。我自己的排查顺序是三步# 1. 看当前执行的是哪个文件 type -a tree # 2. 看两个常见路径下是否都有 tree ls -l /usr/local/bin/tree /usr/bin/tree 2/dev/null # 3. 确认哪个属于包管理器 dpkg -L tree 2/dev/null rpm -ql tree 2/dev/null这组命令不是每次都要跑但一旦遇到“版本怎么不对”“选项怎么没有”这种玄学问题多半是 PATH 里混进了两个 tree。先定位再动手比反复重装省事得多。多个 tree 并存不用慌把 PATH 顺序调对、把不需要的那个卸掉就好最忌讳的是直接删/usr/bin/tree因为包管理器数据库里还记着这个文件之后的升级、卸载都会报错。4. 避坑tree 安装和使用时最容易翻车的 5 个场景4.1 命令找不到装好了却提示 command not found现象用 apt 或 yum 装完 tree退出终端重进输入 tree 仍然提示command not found。部分场景下 sudo tree 能执行普通用户执行就找不到。原因tree 被安装到了/usr/local/bin而当前用户 PATH 里没有这个目录或者当前 shell 是无登录 shell没有加载/etc/profile里的 PATH 配置。还有一种是源码安装时指定了 PREFIX但没把对应 bin 目录加进 PATH。解决# 查看 tree 的真实路径 type -a tree ls -l /usr/local/bin/tree /usr/bin/tree 2/dev/null # 直接用完整路径测试 /usr/local/bin/tree --version如果完整路径能执行就在~/.bashrc里追加一行export PATH/usr/local/bin:$PATH保存后执行source ~/.bashrc再type tree验证。这不是什么高级操作但很多人第一反应是重新安装反复重装永远解决不了 PATH 问题。如果type -a显示路径已经正确而命令仍然失效再看一下是不是 shell 缓存执行hash -r清掉哈希缓存。4.2 源码编译失败缺编译器、缺基础头文件现象在精简系统上执行 make 编译 tree第一行就报gcc: command not found或者报fatal error: sys/types.h: No such file or directory。更常见的是连 make 都提示command not found。原因一个只装了运行环境的 Linux 不一定带编译工具链。源码安装需要编译器、make 命令、基础 C 库头文件这些在桌面发行版默认有但在容器、嵌入式设备、极小化服务器上往往是缺失的。解决先装齐编译工具再回去编译。Debian/Ubuntu 上执行sudo apt-get update sudo apt-get install -y build-essentialRHEL/CentOS 上执行sudo dnf groupinstall -y Development Tools sudo dnf install -y make gcc装完再回到源码目录make clean make -j4 sudo make install注意 make clean 这一步。第一次编译失败会在目录里留下大量.o目标文件和半成品不清理直接重新 make经常会报旧文件干扰。先make clean清掉再重新走一遍。这条经验是从血泪里抄出来的别想着“我只删其中一个 .o”就能省事直接 clean 才是最快路径。4.3 软链接目录不展开树看起来少了很多子目录现象执行tree -L 3 /opt发现有些目录显示成xxx - /var/xxx箭头之后没有任何下级目录数一数文件树比实际目录少了一半。原因tree 默认不会递归进入软链接指向的目录这是为了防止出现 A 链接到 B、B 又链接回 A 的循环引用。没有-l参数时它只把软链接本身当作一个特殊的叶子节点显示。解决确认你要展示的目录结构里没有循环风险并且确实需要跟随软链接显式加-ltree -lL 3 /opt这里-l和-L可以连着写成一个参数组。加了-l之后如果仍然觉得树不对劲检查你给的路径本身是不是软链接。tree 对命令行入参的处理和对树内部链接的处理不同直接执行ls -ld /opt看一眼目录属性再决定是跟/opt还是跟它指向的真实路径。跟踪软链接会放大输出量遇到一个指向大目录的链接一次输出可能几千行。不确定时先用-L 2控制一下规模确认无误后再放开层级。4.4 文件名带空格、换行生成的清单脚本没法读现象用tree filelist.txt生成了文件清单后面写 for 循环按行处理结果包含空格的文件名被拆成了两段统计结果少了文件。更极端的场景是文件名本身含换行直接把清单撑乱。原因tree 默认输出按换行分隔这种设计面向人肉阅读脚本里按行读取时空格、换行、特殊符号都会被当作分隔结构和 tree 的输出语义对不上。解决根据用途分两条路。人肉看直接用默认程序消费用 NUL 分隔或者结构化输出。tree 支持-0参数把条目用 NUL 字符分隔tree -0 files.txt在 bash 里配合 read -d 逐条处理while IFS read -r -d file; do echo got: $file done (tree -0)如果你的 tree 支持输出 JSON更推荐给复杂结构用 JSON让程序去解析不要自己正则拆行tree -J structure.json python3 -c import json,sys; datajson.load(open(structure.json)); print(top-level:, len(data))需要先确认帮助文档里有-J再这么做老版本没有这个选项。不管用-0还是-J核心原则是别用面向眼睛的默认输出去喂脚本那是拿黑匣子当接口用。4.5 重定向文件里出现颜色转义码diff 和 git 没法看现象执行tree -C out.txtcat 看起来正常但用 vim 或 git diff 查看时文件里全是[01;34m、[0m之类的颜色转义序列把差异比较结果弄得没法看。原因-C强制开启颜色。tree 在终端下默认就有颜色但一旦重定向它通常会自己关掉颜色一旦你显式加了-C或者 shell 环境里的 LS_COLORS 被某个版本强制继承重定向文件里就会被写入 ANSI 转义码。解决生成文件时不要加-C。如果脚本里用了某段复制过来的命令先检查里面有没有-C和--color有就删掉。清除环境变量也可以unset LS_COLORS tree --noreport clean.txt注意没有报错不代表输出干净。用cat -v clean.txt | head看一下有没有^[开头的字符那才是转义码的本相。如果确实需要保留颜色比如要把彩色树贴进终端能识别的文件里那是有意为之否则一律以无颜色输出为基础。这条规则同样适用于 tree 以外的所有 Linux 命令行工具。5. 两个把 tree 用出效率的实战技巧磁盘占用和基线比对这一章不是知识点的堆叠而是往前再走一步的用法。已经会安装、会看树之后下面两个技巧可以直接进工作流。第一个是目录占用审计。tree 本身不管文件内容但它支持--du会先统计目录内所有文件的体积再打印目录树配合-h可读性很好tree /var/log --du -h -L 2这个命令会同时展示目录层级和体积适合快速定位“哪个日志目录把磁盘吃光了”。但代价是它会遍历目录下所有子目录来统计大小在大目录上执行可能很慢建议加-L限定层级避免深层次目录被全部扫一遍。统计结果默认不包含以点开头的隐藏文件要精确结果就加-a还要留意它和du的块计算口径不完全一致不能直接画等号。第二个我实际用得多的是基线比对。发布新版本前后把项目目录的树结构分别导出再用 diff 比较能快速看出上线过程到底多了哪些文件、少了哪些目录。我的习惯命令是这样# 发布前生成基线 tree -a -f --noreport before.txt # 发布后再次生成 tree -a -f --noreport after.txt # 比较差异只看变化 diff before.txt after.txt加-f是为了让每一行都带完整路径diff 结果里直接能看到具体文件名。加--noreport是为了去掉统计行否则最后一行 “X directories, Y files” 必然不同diff 里永远多一条噪声。目录特别大时先输出到文件再 diff不要直接在管道里 diff避免两边 I/O 和缓冲互相干扰。比较出来的差异如果全是临时文件说明清理工作没做好如果多出了预期外的配置目录那就要再查一下发布脚本。这个思路也适用在使用 find 的场景但 tree 的可读性更适合做记录留存我一般会把这个输出直接提交到发布文档里下次回溯时一眼看到目录结构在哪个版本发生变化。最后说一个形成习惯的小细节导出 tree 清单之前先export LANGC避免中英文环境切换导致排序不一致diff 结果里出现大段假差异。有了这个习惯就不会被乱序问题骗到。希望这篇东西帮你在 Linux tree 命令的安装和日常使用上少踩几个坑把时间花在真正需要分析目录内容的地方。本文还有配套的精品资源点击获取
