跳到主要内容
面向开发者的免费在线工具

导入文件夹、GitHub/GitLab 仓库或 ZIP,隐藏生成文件,为关键路径添加说明,再将整理好的目录树复制到 README。

无需注册或安装,本地文件夹在浏览器中处理。

文件夹导入仓库 / ZIP 导入对齐注释ASCII / Markdown 导出

在线目录树编辑器

从你的项目生成带注释的目录树

先试用示例,或导入自己的项目。隐藏一个无关目录,为入口文件添加说明,再预览、复制或下载结果。

正在加载在线工作区

目录树编辑器在你的浏览器中运行,因此无需创建账户也能试用完整工作流。

为什么选择 dir-tree

让 README 里的项目结构更容易读懂

完整文件列表往往会淹没读者真正需要的入口。隐藏依赖目录、构建产物和缓存,为重要文件夹补充说明,而不改动磁盘上的文件。

dir-tree 将包含大量无关内容的 tree 命令输出,整理成注释对齐、可用于 README 的项目目录树
隐藏生成目录、对齐注释,并发布 README 可用的项目结构。

直接从已有项目开始

导入文件夹、仓库、ZIP 或已有目录树,不必重新手工输入整个层级。

文件夹导入 · 仓库 URL · ZIP · 远程 ZIP · 树输出

整理前

README 草稿
- 复制的终端输出
- 旧文件夹列表
- 手动清理备注

整理后

my-app/
├── app/              // 路由
├── components/       // 可复用 UI
└── package.json      // 依赖项

只保留需要说明的内容

通过深度限制、忽略规则和隐藏节点,排除生成文件,聚焦真正需要展示的项目结构。

深度 · .gitignore · 排除规则 · 隐藏节点

整理前

$ tree -L 3
.
├── node_modules/
├── .next/
├── dist/
├── src/
└── package.json

整理后

my-app/
├── src/              // 应用代码
└── package.json      // 依赖项

为关键路径补充说明

给文件和文件夹添加注释,选择紧随路径的紧凑排版,或排列整齐的注释列。可以手动填写,也可以审核可选的 AI 建议。

手动注释 · 可选 AI · 注释排版

整理前

├── auth.ts // 认证?
├── api.ts        // 客户端
└── format.ts // 工具函数

整理后

├── auth.ts           // 登录流程
├── api.ts            // API 客户端
└── format.ts         // 文本格式化

导出整理好的结构

复制结果,或下载 Markdown、TXT、JSON,用于 README、技术文档或 Pull Request。

树样式 · Markdown · TXT · JSON

整理前

粘贴原始输出
修正间距
包成代码块
下次重复一遍

整理后

可直接发布
复制到剪贴板
下载 Markdown
下载 TXT
导出 JSON

工作流

导入、整理、注释并导出

把项目导入同一个工作区,选择需要展示的内容,再整理成带注释的目录树用于文档。

dir-tree 在浏览器中导入本地文件夹、GitHub 或 GitLab 仓库、ZIP 文件、远程 ZIP URL 和 tree 命令输出
从文件夹、仓库、ZIP、远程 URL 或已有输出开始。

导入项目

选择本地文件夹、GitHub/GitLab 仓库、ZIP 或已有目录树文本,也可以先试用示例。

文件夹仓库 URLZIP远程 ZIPASCII · JSON · XML · HTML · MD
dir-tree 使用深度限制、.gitignore 规则、排除模式和隐藏构建目录来清理项目目录树
隐藏无关内容、调整展示层级和排列顺序,不修改源文件。

筛选展示内容

限制深度、应用忽略规则并隐藏无关节点,原始文件不会被修改。

深度限制.gitignore隐藏无关内容调整顺序
dir-tree 自定义树样式、对齐注释,并导出 README 可用的 ASCII、Markdown、TXT 和 JSON
调整树样式、对齐注释,然后复制或下载。

添加注释并导出

说明关键路径、选择注释排版,再复制或下载整理好的目录树。

树样式对齐注释Markdown · TXT · JSON · 剪贴板
支持的来源与导出格式
dir-tree 导入与导出流程:导入本地文件夹、GitHub 和 GitLab 仓库、ZIP、目录树文本、JSON、XML、HTML 和 Markdown,再导出 Markdown、ASCII TXT、JSON 或复制到剪贴板
导入文件夹、仓库等来源,统一调整目录树样式和注释,再导出用于文档。
本地文件夹仓库 URLZIP目录树文本JSONXMLHTMLMarkdown
解析 + 标准化已排版的带注释目录树
MarkdownASCII TXTJSON剪贴板

使用场景

为 README、文档、评审和教学整理项目结构

无论读者是第一次接触仓库,还是正在评审结构调整,都可以用合适的细节帮助他们快速理解。

dir-tree 生成的 README 项目结构,包含对齐注释和一致的树样式
在 README 中发布清晰、带注释的项目结构。

README 项目结构

开源维护者和模板作者

展示入口、配置和关键目录,避免被生成文件淹没。

Unicode 输出
Unicode 输出
starter-kit/
├── app/                  // routes and layouts
├── components/           // reusable UI
├── lib/                  // shared utilities
└── README.md             // setup guide
使用带注释目录树作为架构地图的技术文档页面
将项目结构整理成清晰易懂的架构示意图。

带注释的技术文档

技术写作者和开发者布道师

在路径旁说明路由、模型、组件和共享工具的职责。

ASCII 输出
ASCII 输出
api-service/
|-- routes/               // HTTP 端点
|   |-- auth.ts           // JWT 与会话
|   `-- users.ts          // 用户 CRUD
|-- models/               // 数据库 schema
`-- middleware/           // 请求管线
Pull Request 描述使用带注释目录树说明重构范围
用紧凑的带注释树说明重构范围。

Pull Request 结构说明

评审重构的工程师

用简洁的目录图帮助评审者理解重构涉及的结构。

Unicode 输出
Unicode 输出
src/
├── auth/                 // 登录流程
├── hooks/                // 共享 hooks
├── utils/                // 共享辅助函数
└── README.md             // 结构说明
文件夹层级课程展示可视化树和 README 可用的 ASCII 输出
同时向学生展示直观的目录层级和对应的 ASCII 文本。

上手与教学材料

计算机科学讲师和课程创建者

帮助新贡献者和学生找到应该先阅读的文件。

ASCII 输出
ASCII 输出
lesson-01/
|-- starter/              // student begins here
|   `-- index.js          // entry point
`-- solution/             // instructor reference

指南与示例

项目目录树实用指南

通过实用教程,学习如何整理项目结构、添加注释,并生成可直接用于 README 的目录树。

对比

dir-tree 和 tree 命令有什么区别?

终端 tree 适合目录快照和脚本化流程。dir-tree 将文件夹、仓库和 ZIP 导入,与可视化编辑、注释排版、可选 AI 建议和文档导出整合在同一个工作区。

终端 tree

最适合: 快速查看本地目录结构

使用命令选项筛选输出,需要时另行补充路径说明。

tree.nathanfriend.com

最适合: 手写 ASCII 图

适合手写图示,但不能读取真实项目文件夹。

dir-tree

最适合: 可直接用于文档的项目结构

在一个浏览器工作区中导入、编辑、调整样式、注释并导出。

dir-tree 和 tree 命令有什么区别?
功能终端 `tree`tree.nathanfriend.comdir-tree
读取真实本地目录是否是
基于浏览器,无需安装否是是
支持本地和远程 ZIP否否是
导入 GitHub/GitLab 仓库 URL否否是
导入已有 ASCII / JSON / XML 树仅输出有限是
可视化编辑和隐藏节点否仅编辑是
树样式自定义命令参数和手动清理基础视觉选项连接符样式、缩进、根路径显示、元数据和注释模板
注释列对齐否否是
手动和可选 AI 注释否否是
可直接用于文档的 Markdown / TXT / JSON 导出原始输出生成 ASCII带样式和注释

隐私边界

本地处理,数据去向清楚

在浏览器中处理本地文件夹和 ZIP,按需使用远程导入与可选 AI 注释。

01

生成目录树无需上传项目文件

本地项目结构的读取、编辑和导出,都在浏览器中完成。

02

远程导入会访问来源服务

仓库和远程 ZIP 导入会连接你选择的来源。

03

AI 注释由你主动选择

主动请求时发送选定上下文,生成建议由你审核后应用。

dir-tree 隐私边界,展示本地浏览器处理和不含文件内容的可选 AI 注释
本地编辑与导出,按需连接远程来源与 AI。

可选 AI 数据流

  • 你选择的目录节点
  • 已有注释
  • 生成设置
  • AI 提供方
  • 建议注释

AI 使用你提供的上下文,不会自动读取项目源文件。

常见问题

目录树生成器常见问题

导入本地文件夹、GitHub/GitLab 仓库、ZIP 或已有目录树,隐藏生成目录、添加注释,再选择 Unicode 或纯 ASCII 连接符。完成后可以复制结果或导出 Markdown,整个过程不会修改原文件。

选择或拖入本地文件夹后,浏览器会在本地读取文件和文件夹名称及层级,你可以继续过滤、编辑、添加注释并导出目录结构,文件内容不会上传。

dir-tree 可以导入本地文件夹、GitHub/GitLab 仓库 URL、本地 ZIP、远程 ZIP URL、`tree` 命令输出、JSON、XML、HTML 和 Markdown 列表,并将它们转换成可编辑的目录树。

生成目录树不会上传项目文件正文。本地文件夹、ZIP、忽略规则和导入的目录树文本都在浏览器中处理。远程导入会访问 GitHub、GitLab 或 ZIP 所在服务。可选 AI 注释发送所选路径、节点类型、已有注释、设置和提示词,而不是项目源文件。

终端 tree 命令适合目录快照、筛选和脚本化流程。dir-tree 提供浏览器工作区,可以导入不同来源、编辑展示结构、编写并对齐注释,再导出适合文档的结果。

可以。文件和文件夹都能添加说明,并选择紧随路径或对齐列排版。对齐支持自适应、全局单列和按父目录三种策略。导出会保留排版空格,建议在 README 中使用等宽代码块;如果目标字体的字符宽度不同,中英文混排或 emoji 仍可能出现视觉偏差。

Unicode 目录树使用 `├──`、`└──` 等连接符,视觉层级通常更清晰;纯 ASCII 使用 `|--`、`+--` 等基础字符连接符,更适合旧终端或受限文本环境。两种样式都支持注释、复制和导出。

可以。可选 AI 建议基于所选路径、已有注释、生成设置和提示词生成,不会通过读取项目源文件来分析代码。应用前请检查建议,因为仅凭文件名不一定能判断实际用途。每次最多处理 500 个节点,文件和文件夹都计入;当前每个 IP 每天有 10 次免费请求额度,于 UTC 00:00 重置。

可以。你可以限制可见深度、使用 `.gitignore`、应用排除模式、隐藏生成目录、折叠文件夹,并导出用于文档或评审的聚焦目录树。

准备生成你的第一棵目录树了吗?

免费使用目录树编辑器,无需注册或安装。

在浏览器中试用 dir-tree