Linux tree 命令:查看目录树、筛选文件与导出 JSON

tree 将目录与文件的层级关系显示为带缩进和分支线的树形列表。它适合查看项目结构;用 -L 限制深度、用包含或排除模式筛选,可以避免一次输出过多内容。

本文使用 Unix/Linux 的 tree,而不是 Windows 自带的同名命令。内容涵盖安装、隐藏项、文件信息、文本及 JSON/XML 导出;不同发行版的版本可能不同,先用本机帮助确认可用选项。

tree 命令有什么作用?

tree 递归查看指定目录,按深度缩进文件和子目录。不指定路径时,以当前目录 . 为起点。

tree

例如,下面是包含三个子目录和五个文件的结构示意,不是每次运行都会得到的固定结果。在空练习目录中,可先运行 mkdir -p config public src,再运行 touch README.md config/app.conf public/index.html src/main.py src/utils.py 创建这些空文件,然后执行 tree;不要在已有重要项目中覆盖练习文件。

.
├── README.md
├── config
│   └── app.conf
├── public
│   └── index.html
└── src
    ├── main.py
    └── utils.py

3 directories, 5 files

末尾统计的细节可能随版本、筛选和根目录计数方式而不同,应以本机输出为准。ls 命令 更适合逐个查看目录中的项目,tree 则突出多层包含关系。

安装并确认 tree

tree 是独立程序,不是 shell 内建命令,发行版未必默认安装。先确认版本;若提示找不到命令,再按所属发行版选择一种安装方法。

tree --version

Debian 与 Ubuntu

sudo apt update
sudo apt install tree

安装需要管理权限,并要求相应软件源已启用。Ubuntu 24.04 的官方 tree 包位于 Universe;其他版本应查看对应发行版的软件包信息,不要把上游版本号当成本机已安装版本。

Rocky Linux、AlmaLinux、RHEL 与 Fedora

sudo dnf install tree

要求已启用的软件仓库包含 tree 包。旧系统若仍使用 yum,可采用 sudo yum install tree;找不到包时先核对系统版本与仓库状态,不要直接套用其他发行版的仓库。

Arch Linux

sudo pacman -S tree

按当前 Arch 系统的正常更新流程维护软件包数据库;这些安装示例互相独立,不需要依次执行所有发行版的命令。安装后再用 tree --version 和 tree --help 检查。

基本语法与路径参数

tree [options] [directory...]

方括号表示可选项,directory... 表示可指定多个目录,不要把占位符原样输入。以下是独立示例,路径必须实际存在;指定路径不会改变当前工作目录。

tree
tree /etc/nginx
tree ~/projects/app
tree src tests

带空格的目录名要加引号,让 shell 将其作为一个参数传入。

tree "Project Files"

默认末尾显示文件及目录数量;使用 --noreport 可以省略这部分摘要。筛选后的数量不是未筛选目录的完整清单,上游也提示部分过滤组合会影响统计准确性。

tree --noreport

指定目标与最大显示深度

查看其他目录

tree /var/www
tree ./src

第一行查看既有的 Web 目录,第二行查看当前目录下的 src。明确路径有助于区分命令执行位置和查看目标;不存在的路径会产生错误,不能据此判断“目录为空”。

用 -L 限制层级

tree -L 1
tree -L 2 /var/www
tree -L 3 ~/projects/app

起点为第 0 层,直接子项为第 1 层。因此 tree -L 1 只看直接子项,-L 2 还显示再下一层;更深目录可能只显示名称而不展开。先限制深度,再按需要扩大范围,比直接遍历大型目录更方便。

隐藏项与仅目录显示

用 -a 包含点号开头的名称

tree -a
tree -a -L 2

默认不显示 .env、.gitignore 等隐藏文件或隐藏目录。-a 将它们纳入,但不会把特殊目录项 . 和 .. 当作普通子项列出。它通常展示名称而非文件内容,名称本身仍可能透露内部项目或配置用途。

用 -d 只看目录

tree -d
tree -d -L 3 /var/www

文件被省略,适合说明模块布局或备份目录安排。与 -L 合用可控制展开层数;若还要看到隐藏目录,应另外加 -a。

按文件名包含或排除

-P 和 -I 接受 tree 的通配模式,不是正则表达式。用单引号保护模式,避免 shell 提前展开星号或把竖线当作管道;tree 内部使用 | 分隔多个候选模式。

用 -P 选择匹配的文件

tree -P '*.py'
tree -P '*.jpg|*.png|*.webp'

例如第一行选择 Python 文件。目录通常仍会保留用于展示结构,即使它们没有匹配的文件;要隐藏筛选后为空的枝条,可加 --prune。

tree -P '*.py' --prune

隐藏文件还需要 -a 才参与匹配。需要对目录名称应用包含模式时,应查看支持版本的 --matchdirs 行为,不能把普通 -P 当成对全部目录的简单名称过滤。

用 -I 排除不需要的分支

tree -I 'node_modules|.git|dist|__pycache__'
tree -L 3 -I '*.log|tmp|cache'

依赖、缓存、构建结果等通常不必放进项目结构说明。排除目录也会避免展开该分支;这些选项只控制列表,不会删除文件或更改 Git 状态。

用 --gitignore 读取忽略规则

tree --gitignore
tree -a --gitignore -L 3

支持该选项的版本会读取相关 .gitignore,并按手册规定查找上级规则及 .git/info/exclude 等。规则筛选不等于完整重现 Git 对已跟踪文件的处理,也不能当作敏感名称检查的替代品。先确认 tree --help 是否支持,再直接检查准备分享的结果。

查看大小、权限与时间

文件大小与目录累计大小

-s 显示字节大小,-h 本身即可显示易读的大小后缀,如 K、M、G,不必一定再加 -s。它们展示的文件长度不等于实际磁盘分配空间;目录自身的大小也不是内部文件总和。

tree -s
tree -h

--du 汇总所遍历目录树中各文件及子目录的大小,并隐含 -s;加 -h 可换算单位。

tree --du -h -L 2

深度、过滤和访问权限会限定可遍历内容,不要把受限列表的累计值理解为完整目录的磁盘占用审计。需要区分实际占用与逻辑长度时,可使用 du 命令。--du 要先收集树的信息,大目录可能延迟输出并消耗较多内存。

权限、所有者、组与修改时间

tree -p
tree -pug
tree -pugD -L 2

-p 显示类型和权限,-u 显示用户名称或 ID,-g 显示组名称或 ID。-D 默认显示最后修改时间;若同时使用 -c,则改为状态变更时间,后者不是文件创建时间。长用户名、元数据和路径会增加行宽;权限字符串也不能独自反映全部 ACL 或安全策略。

调整排序与路径显示

目录优先和其他排序

tree --dirsfirst
tree -t
tree --sort=size -r

--dirsfirst 让目录排在文件前面;-t 改按最后修改时间排序,--sort=size 改按大小排序,-r 反转相应顺序。要保留文件系统读取的目录顺序可用 -U,此时目录优先及反转排序不生效;目录读取顺序本身不保证跨运行固定。

显示路径前缀并去掉分支线

tree -f
tree -fi --noreport

-f 为项目显示从指定起点延伸的路径前缀,起点是相对路径时,结果也可以是相对路径,并不自动变成以 / 开始的绝对路径。-i 去掉缩进线,--noreport 去掉末尾统计。

这种列表适合人阅读,但文件名中的换行、转义和链接箭头会让简单文本解析含糊。脚本遍历任意文件名时,应考虑 find -print0 等明确使用 NUL 分隔的方案,不要把每一显示行都当作可靠的原始文件名。

保存文本与结构化结果

保存文本文件

-o 把输出写入指定文件。以下命令会创建或覆盖同名输出文件,运行前确认无需保留旧内容;输出文件位于被遍历目录内时,也可能进入列表,想避免这种影响可把结果保存在树外。

tree -L 3 -o directory-structure.txt
tree -a -I '.git|node_modules' --noreport -o project-tree.txt

也可以用 shell 重定向。-n 关闭颜色;不要同时通过 -C 强制开启颜色,否则控制序列可能混入保存内容。

tree -n -L 3 > directory-structure.txt

重定向由 shell 在启动命令前打开文件,因此即使命令失败,原有输出文件也可能已被截断。保存后检查命令状态与文件内容,再用于文档。

导出 JSON 与 XML

tree -J -L 3 > directory-structure.json
tree -X -L 3 > directory-structure.xml

-J 输出 JavaScript 对象表示法(JSON)数组,-X 输出可扩展标记语言(XML)。结构化结果适合后续程序分析,但字段与格式细节可能随版本或选项变化;消费者应先查看实际输出,用相应解析器读取,并检查执行错误。两行命令分别生成不同文件,同样可能覆盖已有结果。

符号链接与文件系统边界

是否跟随目录链接

默认显示符号链接名称及其目标,但不进入链接指向的目录。-l 允许沿目录链接继续遍历。

tree -l -L 3

这可能把目标范围扩展到预期外的位置。虽然程序会避开检测到的递归链接,仍应配合深度限制并核对范围,不能把链接循环检测当作完整的访问边界。

用 -x 限制到同一文件系统

tree -x -L 3 /

-x 避免进入与起点不同的文件系统,适合有多个挂载点的服务器;它不是排除所有挂载点的通用选项,同一设备上的绑定挂载等情况不能仅靠它隔离。示例查看根目录仍可能输出很多内容,并受当前账户权限限制。

常用命令组合

命令 用途
tree 显示当前目录的层级结构。
tree -L 2 最多显示两层子项。
tree -a 包含隐藏文件和隐藏目录。
tree -d 只显示目录。
tree -I 'node_modules|.git' 排除指定名称模式的文件和目录。
tree -P '*.py' --prune 突出包含匹配 Python 文件的分支。
tree -h --du -L 2 在受限遍历范围内显示累计大小。
tree -pugD 同时显示权限、用户、组和时间。
tree -fi --noreport 输出不带分支线和摘要的路径列表。
tree -J -L 3 将三层结构输出为 JSON。

主要选项速查

选项 说明
-a 包含点号开头的隐藏项。
-d 只显示目录。
-L 数字 限制显示的最大深度。
-P 模式 选择匹配通配模式的文件。
-I 模式 排除匹配模式的文件和目录。
--prune 从输出中移除筛选后为空的目录。
--gitignore 用 Git 忽略文件的规则筛选。
-f 显示从起点延伸的完整路径前缀。
-h 用易读单位显示大小。
--du 累计遍历范围中的目录大小。
-p 显示类型与权限。
-D 默认显示最后修改时间。
--dirsfirst 目录排在文件前面。
-J 输出 JSON。
-X 输出 XML。
-o 文件 将结果写入指定文件。
-l 跟随指向目录的符号链接。
-x 不跨越到不同文件系统。
--noreport 省略末尾数量摘要。

大型目录的检查要点

先限制深度与范围

不要一开始就对整个根目录、全部主目录或庞大依赖树做无限制遍历。先指定需要的项目路径,配合 -L 和排除规则;若终端输出过多,可用 Ctrl+C 停止,再缩小范围重试。

理解累计与剪枝的成本

--du 和 --prune 会先把相应树信息收集到内存,之后才输出,因而首屏延迟不一定表示程序卡死。过滤条件和权限也影响结果,不能用不完整的统计替代完整清点。

权限错误与分享前检查

没有读取或搜索权限的目录不能完整列出。先核对必要路径和授权,避免只为看完整结构就使用管理员权限。分享输出前,检查其中的用户名称、内部服务器路径、配置文件名和项目代号;按所需范围删去无关信息后再附到文档或问题单。

常见问答

为什么出现 tree: command not found?

通常是未安装或程序不在 PATH。使用所属发行版的包管理器安装,再用 tree --version 确认;注意不要误用 Windows 的同名命令。

怎样只显示两层子目录?

使用 tree -L 2。查看别处可写成 tree -L 2 /path/to/check,将示例路径替换为实际存在的目录。

能同时排除 node_modules 和 .git 吗?

可以,使用 tree -I 'node_modules|.git'。单引号防止 shell 提前解释竖线和通配符。

怎样生成适合放进 README 的结构?

可用 tree -L 3 -I '.git|node_modules|dist' --noreport,先限制层级并排除无关目录。确认没有内部或敏感名称后,用 Markdown 的围栏代码块保存分支缩进;不要把输出误当成完整文件清单。

参考资料