文件夾目錄樹生成

文件夾目錄樹生成工具用於把一個本地文件夾或一組路徑轉換成樹形縮進文本，可直接粘貼到 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：可以，頁面已適配移動端與深色模式。手機瀏覽器選擇文件夾的限制較多，此時建議使用「用路徑生成」粘貼路徑的方式。