Mac终端需用tree命令查看项目嵌套结构,先装Homebrew再brew install tree;基础用法为tree,可加-L限制层级、-d仅显示目录、-a显示隐藏文件、-I排除指定目录,支持重定向导出为文本文件。

要在Mac终端中快速看清项目里几十个子文件夹和文件的嵌套关系,必须用tree命令生成清晰的树形目录结构,否则靠ls一层层cd进去翻,效率极低。
安装tree命令
macOS系统出厂不带tree命令,需先装Homebrew再装tree。如果你还没装Homebrew,先运行:
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
装完后执行:
brew install tree
这一步不可跳过,【没有tree命令就无法执行后续所有操作】。
基础用法:直接显示当前目录树
进入目标文件夹后,输入tree并回车。
例如想看Hugo站点content目录的结构,先cd content,再运行tree。
输出会自动带缩进线条、分支符号,并在末尾统计目录数和文件数,比如“7 directories, 5 files”。
控制输出深度与范围
方法一:限制层级,避免刷屏
tree -L 2 → 只显示当前目录及下一级子目录,适合顶层结构概览。
tree -L 3 → 多展开一层,能看清组件目录下的模块划分。
注意:-L后面必须紧跟数字,中间不能有空格,写成tree -L3或tree -L 3都行,但tree -L 3(两个空格)会报错。
方法二:只看目录,忽略所有文件
tree -d
这对梳理项目骨架特别有用——比如确认src→components→ui的路径是否存在,完全不用被.vue/.js文件干扰视线。
方法三:强制显示隐藏文件(如.git、.DS_Store)
tree -a
默认tree会跳过以点开头的隐藏项,加-a才会展开。如果你正在排查git提交异常,这一步必不可少。
过滤掉干扰性大目录
第一步:进入你要分析的项目根目录,比如cd ~/my-hugo-site
第二步:运行tree -I "node_modules|public|.git"
第三步:观察输出——所有匹配名称的目录都被剔除,树形图立刻清爽很多。
注意:-I参数值必须用英文双引号包裹,且多个排除项用竖线|分隔,【漏掉引号会导致命令直接失败,报错‘Illegal option’】。
导出为文本文件供分享或存档
tree -L 4 -I "node_modules|dist|tmp" > structure.md
这条命令会把四层深、排除了三个常见构建目录的结构,完整写入当前目录下的structure.md文件。
如果想追加内容而不是覆盖,把>换成>>即可。
生成后直接code structure.md就能在VS Code里查看带语法高亮的树状图。











