工具介绍
本地目录树生成器是由灯塔码铺出品的一款免费在线文件夹结构可视化工具。
你可以选择电脑上的任意目录，在浏览器中即时生成类似 Linux / macOS
tree 命令的目录树，并支持复制为纯文本，方便写入 README、文档或发给同事。
与传统桌面软件不同，灯塔码铺目录树工具不需要安装 exe，也不上传你的文件。 目录读取与树形渲染全部在本地浏览器完成，适合整理项目结构、核对发布包内容、给文档配图前先导出结构文本。
主要功能
- 选择 / 拖拽文件夹：一键读取本地目录，生成可折叠目录树。
- 文本树导出：右侧输出
├──/└──风格文本，可一键复制。 - 默认排除噪音文件：可跳过
node_modules、.git、.DS_Store、dist等常见目录与系统文件。 - 自定义排除与只显示：支持多条规则，后缀（如
*.log）、模糊匹配（如*test*）。 - 排序：按实际位置展示，或按文件名升序 / 降序。
- 深度控制：限制最大层级，避免超大仓库一次展开过多。
- 树上快捷筛选：每个节点可快速「排除」或「只显示」，规则实时生效。
- 隐私友好：文件不离开你的电脑，适合处理含隐私或未开源的项目目录。
使用方法
- 点击选择文件夹（推荐 Chrome / Edge），授权读取某个本地目录；也可把文件夹拖到虚线区域。
- 左侧查看可折叠目录树，右侧查看可复制的文本树。
- 按需勾选「跳过常见重目录」「只显示文件夹」，或调整最大深度与排序方式——修改后会实时刷新。
- 在「自定义排除 / 只显示」中按行填写规则；也可直接点树节点旁的 ⊖（排除）或 ⊕（只显示）。
- 点击复制文本树，粘贴到 Markdown、文档或聊天中即可。
筛选规则怎么写？
- 精确名称：
dist、.env - 后缀：
.map或*.js - 模糊：
*cache*、foo*、*test* - 多条规则每行一条，为「或」关系；排除与只显示可同时使用（先排除，再白名单）。
浏览器兼容与「备用选择」说明
网页不能静默扫描整台电脑，必须由你主动授权某个文件夹。 不同浏览器提供的授权方式不同，所以本工具准备了三种入口：
| 入口 | 适用浏览器 | 说明 |
|---|---|---|
| 选择文件夹 | Chrome、Edge、新版 Chromium 内核浏览器 |
使用 File System Access API（showDirectoryPicker），体验最好，可直接授权整目录只读访问。
|
| 备用选择 | Firefox、Safari，以及不支持新 API 的环境 |
使用传统的 <input webkitdirectory>。弹出系统文件框选中文件夹后同样能生成目录树，是兼容性兜底方案。
|
| 拖拽文件夹 | 多数桌面浏览器 | 把文件夹拖到虚线区域即可；若拖拽无效，请改用上面两个按钮。 |
为什么要有「备用选择」？ 因为「选择文件夹」依赖较新的浏览器能力，Firefox / Safari 往往还不支持或支持不完整。 备用选择走的是老牌目录上传控件，兼容面更广；功能目标相同，只是系统弹窗样式和权限提示略有差异。 若你使用 Chrome / Edge，优先点「选择文件夹」即可，一般用不到备用入口。
移动端浏览器对本地目录访问限制更多，建议在电脑端使用以获得完整体验。
可能遇到的问题
1. 点了「选择文件夹」没反应或提示不支持
当前浏览器可能不支持 File System Access API。请改用备用选择或拖拽文件夹； 或换用最新版 Chrome / Edge。
2. 目录特别大，页面卡住或很慢
超大仓库（尤其未排除 node_modules）会产生海量节点。请勾选「跳过常见重目录」、减小「最大深度」，
或用排除规则过滤构建产物与缓存目录后再查看。
3. 改了筛选条件，树没有变化
请确认已经成功选过文件夹。本工具会缓存完整目录结构，筛选应实时生效；若仍异常，可重新选择一次文件夹。
4. 复制失败
少数环境会限制剪贴板权限。可直接在右侧文本框中全选（Ctrl/Cmd + A）再复制（Ctrl/Cmd + C）。
5. 担心隐私：会不会上传到服务器？
不会。目录遍历与渲染都在你的浏览器里完成，服务器收不到你的文件内容。 你看到的广告位与友链不影响本地目录读取逻辑。
6. 和系统自带的 tree 命令有什么区别？
系统 tree 需要安装命令行工具，且不方便给非技术同事使用。
灯塔码铺目录树工具提供可视化折叠、图形化筛选按钮和一键复制，更适合写文档、分享项目结构；
导出的文本格式与常见 tree 输出接近，可直接贴进 Markdown。
适用场景
- 给 README / 技术文档配「项目目录结构」说明
- 发布前检查打包目录是否混入多余文件
- 整理资料盘、素材库，快速摸清层级
- 教学演示时展示文件夹组织方式