📖 工具介绍

项目文件树生成器是一款完全免费、即开即用的在线目录可视化工具。写技术文档、提交开源项目 README、给团队讲解项目结构时，一张清晰的文件树能让读者瞬间建立全局认识。本工具把手工整理目录结构的过程彻底自动化：你可以直接在浏览器中选择整个项目文件夹，工具会递归读取其中所有文件的相对路径；也可以在文本框中每行粘贴一条路径（支持斜杠或反斜杠分隔）。两种输入可以混合使用。工具会在浏览器本地把路径列表构造成嵌套树，目录节点自动前置并按字母排序，再以标准的 ├── 与 └── 树符号逐层缩进渲染，目录节点以青色高亮，文件节点保持普通颜色，右侧预览窗同步显示文件数与目录数统计。确认无误后，你可以一键复制树文本贴入 Markdown 文档，或下载为 .txt 保存。由于工具只读取路径元数据，完全不读取文件内容，即便项目中含有敏感源码也可以放心使用。全部处理均在本地完成，文件夹不会上传任何服务器。界面支持简体中文、繁体中文与英文三语，自动跟随网站主题色，电脑与手机均可顺畅使用。

✨ 功能特点

• 两种输入：直接选择整个文件夹递归读取，或手动粘贴路径列表
• 标准树符号：使用 ├── └── 逐层缩进，目录节点青色高亮
• 智能排序：目录自动排在文件之前，同级按字母顺序排列
• 混合输入：文件夹选择与文本框路径可同时使用、自动合并
• 实时统计：预览窗顶部显示文件数与目录数
• 本地隐私：只读取路径元数据，不打开文件内容，零上传

📝 使用方式

1. 点击虚线框选择整个项目文件夹，或在文本框每行粘贴一条路径
2. 工具自动生成树状文本，目录前置、字母排序
3. 查看右侧预览窗，确认文件数与目录数统计
4. 点击「复制树文本」贴入 README 或文档，或下载 .txt 保存
5. 点击「清空」可开始下一次目录整理

⚠️ 注意事项

• 路径来源：文件夹模式读取 webkitRelativePath，文本模式需自行保证路径规范
• 分隔符兼容：粘贴路径同时兼容正斜杠与反斜杠
• 空路径跳过：空行与纯空白行自动忽略，不影响树结构
• 节点着色：青色行表示包含子节点的目录，普通行表示叶子文件
• 大目录限制：数万级文件的超大目录建议分批粘贴，避免浏览器卡顿