从文本输入或文件路径生成目录树结构。支持各种格式和自定义选项。
工具功能
- 可视化树形结构: 使用 ASCII 字符(├──、└──、│)生成清晰的目录树,通过适当的缩进和分支连接可视化文件系统层次结构
- 多种输出格式: 支持多种格式,包括 ASCII 艺术字符、Unicode 方框绘图、Markdown 风格缩进和适合 README 文档的纯文本格式
- 自定义选项: 配置树形字符、缩进宽度、文件/文件夹图标、排序规则和过滤选项,以匹配您的文档风格
- 一键复制: 即时将生成的树形结构复制到剪贴板,方便粘贴到 README 文件、文档或代码注释中
使用方法
- 第一步: 输入目录路径或文件结构。
- 第二步: 生成目录树。
- 第三步: 复制生成的树。
生成原理
树结构表示
目录树表示使用 ASCII 字符(│、├、└、─)来可视化层次化的文件系统结构。每个嵌套级别通过缩进和连接线表示,创建清晰的父子关系。树格式遵循 Unix 'tree' 命令约定,使用框线绘制字符表示分支和连接,使复杂的目录结构易于阅读且适合文档化。
路径解析和层次构建
生成器通过在目录分隔符(/ 或 \)上拆分文件路径来解析它们,从嵌套路径构建树数据结构。每个路径段成为一个节点,子节点按字母顺序或自定义规则排序。算法处理边缘情况,如重复路径、空目录和特殊字符。它使用深度优先或广度优先遍历构建层次结构,确保正确的嵌套关系。
输出格式化选项
树输出支持多种格式,包括 ASCII 艺术(使用 ├──、└──、│)、Unicode 框线绘制字符、仅缩进(Markdown 风格)以及 JSON/XML 结构化格式。自定义选项控制分支字符、缩进宽度、文件/文件夹图标、不同文件类型的颜色编码,以及是否显示隐藏文件。格式化器还可以为 HTML 文档生成可点击的树或为 README 文件生成纯文本。
常见问题
- 输入文本应该如何格式化?
- 请将每个文件夹或文件路径单独放在一行,并用两个空格或一个制表符表示嵌套层级。无论是粘贴文本还是上传文件,生成器都会自动识别缩进结构。
- 能否快速导入真实的项目结构?
- 可以。请在终端运行 `tree -F -I node_modules` 或 `find . -maxdepth 4` 等命令,复制输出后粘贴,或者拖放包含目录列表的文本或 Markdown 文件,工具会立即还原层级。
- 如何让 README 里的树形结构保持整洁?
- 复制前先限制深度、过滤掉 `dist`、`node_modules` 等大型目录,并在 README 中用 ```text 代码块包裹结果,就能保持 ASCII 分支对齐。
相关文档
- Unix tree 命令手册 - Unix/Linux tree 命令的官方文档,展示目录结构可视化的标准格式
- ASCII 艺术字符参考 - 用于绘制树形结构的 ASCII 方框绘制字符完整参考
- Markdown 文档最佳实践 - 在 README 文件中使用目录树结构的指南
- 文件系统层次结构标准 - Linux 和 Unix 系统的标准文件系统目录结构
- 项目文档化最佳实践 - 如何有效地记录和可视化项目结构的指南