
导入项目
选择本地文件夹、GitHub/GitLab 仓库、ZIP 或已有目录树文本,也可以先试用示例。
在线目录树编辑器
先试用示例,或导入自己的项目。隐藏一个无关目录,为入口文件添加说明,再预览、复制或下载结果。
正在加载在线工作区
目录树编辑器在你的浏览器中运行,因此无需创建账户也能试用完整工作流。
为什么选择 dir-tree
完整文件列表往往会淹没读者真正需要的入口。隐藏依赖目录、构建产物和缓存,为重要文件夹补充说明,而不改动磁盘上的文件。

导入文件夹、仓库、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
工作流
把项目导入同一个工作区,选择需要展示的内容,再整理成带注释的目录树用于文档。

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

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

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

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

开源维护者和模板作者
展示入口、配置和关键目录,避免被生成文件淹没。
starter-kit/ ├── app/ // routes and layouts ├── components/ // reusable UI ├── lib/ // shared utilities └── README.md // setup guide

技术写作者和开发者布道师
在路径旁说明路由、模型、组件和共享工具的职责。
api-service/ |-- routes/ // HTTP 端点 | |-- auth.ts // JWT 与会话 | `-- users.ts // 用户 CRUD |-- models/ // 数据库 schema `-- middleware/ // 请求管线

评审重构的工程师
用简洁的目录图帮助评审者理解重构涉及的结构。
src/ ├── auth/ // 登录流程 ├── hooks/ // 共享 hooks ├── utils/ // 共享辅助函数 └── README.md // 结构说明

计算机科学讲师和课程创建者
帮助新贡献者和学生找到应该先阅读的文件。
lesson-01/ |-- starter/ // student begins here | `-- index.js // entry point `-- solution/ // instructor reference
指南与示例
通过实用教程,学习如何整理项目结构、添加注释,并生成可直接用于 README 的目录树。
对比
终端 tree 适合目录快照和脚本化流程。dir-tree 将文件夹、仓库和 ZIP 导入,与可视化编辑、注释排版、可选 AI 建议和文档导出整合在同一个工作区。
| 功能 | 终端 `tree` | tree.nathanfriend.com | dir-tree |
|---|---|---|---|
| 读取真实本地目录 | 是 | 否 | 是 |
| 基于浏览器,无需安装 | 否 | 是 | 是 |
| 支持本地和远程 ZIP | 否 | 否 | 是 |
| 导入 GitHub/GitLab 仓库 URL | 否 | 否 | 是 |
| 导入已有 ASCII / JSON / XML 树 | 仅输出 | 有限 | 是 |
| 可视化编辑和隐藏节点 | 否 | 仅编辑 | 是 |
| 树样式自定义 | 命令参数和手动清理 | 基础视觉选项 | 连接符样式、缩进、根路径显示、元数据和注释模板 |
| 注释列对齐 | 否 | 否 | 是 |
| 手动和可选 AI 注释 | 否 | 否 | 是 |
| 可直接用于文档的 Markdown / TXT / JSON 导出 | 原始输出 | 生成 ASCII | 带样式和注释 |
隐私边界
在浏览器中处理本地文件夹和 ZIP,按需使用远程导入与可选 AI 注释。
本地项目结构的读取、编辑和导出,都在浏览器中完成。
仓库和远程 ZIP 导入会连接你选择的来源。
主动请求时发送选定上下文,生成建议由你审核后应用。

可选 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`、应用排除模式、隐藏生成目录、折叠文件夹,并导出用于文档或评审的聚焦目录树。