文件夹目录树生成

文件夹目录树生成工具用于把一个本地文件夹或一组路径转换成树形缩进文本，可直接粘贴到 README、技术博客、需求文档或问题描述中。工具在浏览器中读取目录与文件的名称和层级关系，不读取文件内容、不上传文件，因此也适合展示包含敏感命名的项目结构。

核心功能

• 选择或拖入文件夹：点击页面顶部区域选择文件夹，或直接把文件夹拖进来，即刻生成完整的树形结构。
• 拖拽可保留空目录：以拖拽方式读取文件夹时，空的子目录也会一并显示，适合展示尚未填充内容的项目骨架。
• 按路径生成：当浏览器不方便选择文件夹时，可以一行粘贴一个路径，目录以 / 结尾，工具会还原成同样的树形结构；粘贴绝对路径时会自动识别公共上级目录，只展示有意义的那一层。
• 示例数据填充：路径面板内置「填充示例数据」按钮，一键写入一组演示路径，快速体验生成效果。
• 忽略名单：一行填写一个需要屏蔽的名称，支持 * 通配符批量匹配，默认已预置 node_modules、.git、dist、build、__pycache__ 等常见目录，修改后结果自动刷新。
• 层级限制：可设置最多显示层数，超出部分以省略号收束，避免层级过深的仓库占满屏幕。
• 显示细节开关：文件夹排在前面、显示根目录名称、文件夹末尾添加斜杠，三个开关可按输出用途自由组合。
• 统计与导出：结果区顶部显示文件夹与文件数量，支持一键复制或下载为 TXT 文件，文件名跟随根目录名称。
• 输入内容保留：粘贴的路径、忽略名单与层数设置会留在本机，刷新页面后自动填回，方便反复调整。
• 多根与排序：支持一次展示多个并列根目录，同级条目按名称排序，名称中的数字按自然顺序排列。

适用场景

• 在 README 或项目文档中展示目录结构，让协作者一眼看懂工程组织方式。
• 提交问题反馈、在社区提问或做代码评审时，说明某个文件所在的具体位置。
• 整理笔记库、素材库、归档资料，导出结构清单用于备份核对。
• 撰写教程或技术博客时，展示「目录应该建成什么样」的标准骨架。
• 项目交接、编写部署说明前，留存一份当前结构的文字快照。

使用方法

1. 点击页面顶部区域选择需要展示的文件夹，或直接把文件夹拖拽到该区域。
2. 如需屏蔽某些目录或文件，在「忽略这些名字」中逐行填写名称，或使用 * 通配符匹配一批名称。
3. 按需设置最多层数，并调整文件夹优先、显示根目录、末尾添加斜杠等开关，结果实时更新。
4. 确认内容无误后点击「复制」或「下载 txt」，把树形文本放入目标文档。

关于树形目录

树形目录用缩进和分支符号表示层级：同级条目通过竖线与分支角标连接，最后一个条目使用不同的角标结尾。相比单纯的列表，它更容易看出「哪些文件属于哪个目录」「这个目录还有没有下级」。这种写法常见于代码仓库说明，也常见于终端目录树命令的输出，粘贴到任何支持等宽排版的文档中都能保持对齐。

常见问题（FAQ）

Q：选择的文件夹里有空目录，为什么结果里没有显示？

A：点击选择文件夹的方式只能拿到文件所在的路径，没有文件的空目录不会被读取。需要保留空目录时，请直接把文件夹拖拽到页面顶部的区域。

Q：文件会被上传到服务器吗？

A：不会。工具只读取名称与层级关系，不读取文件内容，也不上传任何文件，生成的文本由你自行复制或下载。

Q：可以直接粘贴已经排好格式的目录树吗？

A：不可以。「用路径生成」需要一行一个路径，例如 src/index.js、README.md、logs/。如果粘贴的内容带有分支符号或代码块标记，工具会给出提示，请改成路径列表后再生成。

Q：目录和文件很多的时候会不会一直卡着？

A：读取大型目录时，结果区会显示处理进度，完成后自动呈现完整结构。配合忽略名单与层级限制，可以进一步减少无关条目、让输出更紧凑。

Q：手机上可以使用吗？

A：可以，页面已适配移动端与深色模式。手机浏览器选择文件夹的限制较多，此时建议使用「用路径生成」粘贴路径的方式。