從文字輸入或檔案路徑生成目錄樹結構。支援各種格式和自訂選項。
工具功能
- 視覺化樹形結構: 使用 ASCII 字元(├──、└──、│)生成清晰的目錄樹,通過適當的縮排和分支連接視覺化檔案系統層次結構
- 多種輸出格式: 支援多種格式,包括 ASCII 藝術字元、Unicode 方框繪圖、Markdown 風格縮排和適合 README 文件的純文字格式
- 自訂選項: 設定樹形字元、縮排寬度、檔案/資料夾圖示、排序規則和篩選選項,以符合您的文件風格
- 一鍵複製: 即時將生成的樹形結構複製到剪貼簿,方便貼上到 README 檔案、文件或程式碼註解中
使用方法
- 第一步: 輸入目錄路徑或檔案結構。
- 第二步: 生成目錄樹。
- 第三步: 複製生成的樹。
生成原理
樹結構表示
目錄樹表示使用 ASCII 字元(│、├、└、─)來視覺化層次化的檔案系統結構。每個嵌套層級通過縮排和連接線表示,建立清晰的父子關係。樹格式遵循 Unix '樹狀' 命令約定,使用框線繪製字元表示分支和連接,使複雜的目錄結構易於閱讀且適合文件化。
路徑解析和層次構建
生成器通過在目錄分隔符(/ 或 \)上拆分檔案路徑來解析它們,從嵌套路徑構建樹資料結構。每個路徑段成為一個節點,子節點按字母順序或自訂規則排序。演算法處理邊緣情況,如重複路徑、空目錄和特殊字元。它使用深度優先或廣度優先遍歷構建層次結構,確保正確的嵌套關係。
輸出格式化選項
樹輸出支援多種格式,包括 ASCII 藝術(使用 ├──、└──、│)、Unicode 框線繪製字元、僅縮排(Markdown 風格)以及 JSON/XML 結構化格式。自訂選項控制分支字元、縮排寬度、檔案/資料夾圖示、不同檔案類型的顏色編碼,以及是否顯示隱藏檔案。格式化器還可以為 HTML 文件生成可點擊的樹或為 README 檔案生成純文字。
常見問題
- 輸入內容應該怎麼排版?
- 請將每個資料夾或檔案路徑獨立寫在一行,並用兩個空白或一個 Tab 表示巢狀層級。無論是貼上文字還是上傳檔案,產生器都會自動判斷縮排。
- 可以快速匯入真實專案的結構嗎?
- 可以。在終端機執行 `樹狀 -F -I node_modules` 或 `尋找 . -maxdepth 4` 等指令,複製輸出後貼上,或拖放含有目錄清單的文字或 Markdown 檔,工具會立即重建層級。
- README 要怎麼保持樹狀結構整齊?
- 在複製前限制深度、排除 `dist`、`node_modules` 等大型資料夾,並在 README 內用 ```文字 程式碼區塊包住輸出,就能維持 ASCII 分支對齊。
相關文件
- Unix 樹狀 命令手冊 - Unix/Linux 樹狀 命令的官方文檔,展示目錄結構視覺化的標準格式
- ASCII 藝術字元參考 - 用於繪製樹形結構的 ASCII 方框繪圖字元完整參考
- Markdown 文件最佳實踐 - 在 README 檔案中使用目錄樹結構的指南
- 檔案系統層次結構標準 - Linux 和 Unix 系統的標準檔案系統目錄結構
- 專案文件化最佳實踐 - 如何有效地記錄和視覺化專案結構的指南