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 的围栏代码块保存分支缩进;不要把输出误当成完整文件清单。




