macOS原生Quick Look不支持多级目录树预览，需结合tree命令生成结构快照与QL插件增强内容预览：用tree导出目录树至文本/Markdown，配合QLColorCode、QLMarkdown、BetterZipQL等插件实现代码高亮、Markdown渲染及压缩包内文件直览，再通过qlmanage -r刷新服务。
macos 原生的 quick look（空格键预览）不支持“多级目录树”结构的可视化预览——它只能展示单个文件内容或图标，无法像 tree 命令那样递归展开整个文件夹层级。所谓“目录树预览”，本质是两种能力的组合：一是快速查看目录结构（终端命令），二是让 finder 预览功能支持更丰富的文件类型（插件扩展）。下面分两部分说明如何真正实现这一目标。
用 tree 命令生成并临时预览目录树
这是最直接、可靠、无需安装额外插件的方式：
- 确保已安装
tree：brew install tree（如未装 Homebrew，请先安装） - 进入目标目录后运行：
tree -L 3 -I "node_modules|dist|build|.git"（-L 3限制3层深度，-I忽略干扰目录） - 想快速预览结果？把输出重定向到临时文件再用 Quick Look 打开：
tree -L 4 > /tmp/dir-tree.txt && open -g /tmp/dir-tree.txt，系统会用 TextEdit 打开，也可配合 QLColorCode 插件获得更好可读性
增强 Quick Look 以支持代码/配置/压缩包等关键文件类型
虽然不能预览“目录本身”，但能大幅提升你对目录中各类文件的理解效率，间接达成“结构感知”效果：
-
代码文件高亮预览：安装
QLColorCode，支持 Python、JS、Rust、YAML、TOML 等60+语言，语法着色准确，无需打开编辑器就能判断文件用途 -
Markdown/配置文件渲染：搭配
QLMarkdown，可实时渲染.md、.yml（需配合 QLStephen 补全无扩展名文件识别） -
压缩包内容直览：安装
BetterZipQL插件（非 BetterZip 软件本体），启用后按空格即可展开 ZIP/RAR/7z 内部目录树，点击子文件还能二次预览 - 安装后必须刷新服务：
qlmanage -r，再 Option+右键点击 Finder 图标 → “重新开启”
目录结构导出 + 快速复用技巧
把结构变成可存档、可分享、可比对的资产，才是真正提升协作和排查效率的关键：
- 导出为带缩进的纯文本：
tree -L 4 -I "node_modules|public|.DS_Store" > structure.txt - 导出为 Markdown 格式（便于文档嵌入）：
tree -L 3 -o structure.md --dirsfirst --noreport（需 tree v2.1+） - 绑定快捷键：在 Terminal 中创建 alias，例如
alias lt='tree -L 2 -I "node_modules|dist|.git"'，输入lt即可秒出主干结构 - 结合
find和tree定位特定类型文件位置：find . -name "*.md" -exec dirname {} \; | sort -u | xargs tree -L 1
不需要强行让 Quick Look 显示“文件夹的树形图”，而是用 tree 做结构快照，用 Quick Look 插件做内容洞察，两者配合才是 macOS 下高效理解复杂目录的真实路径。
