隨著專案迭代,除了程式碼越來越龐大外,資料夾結構也越來越複雜。
到後來,可能連開發人員自己都搞不清楚每個資料夾在做什麼事。
為了避免交接、教育訓練時要花很多時間回憶、解釋,我們應該把這些資訊記錄到文件中。
這邊推薦一個直接產生資料夾結構的套件「tree」,透過簡單的指令就能生成樹狀的目錄結構,以此加速文件撰寫。

▋ 安裝 tree 套件
在 Windows & Mac 有安裝 npm 的電腦上,只要輸入如下指令便可安裝。
npm install -g tree-cli
安裝好後,可透過 tree -h
查看有哪些指令可以使用。

官方文件中有提醒,Windows 要用「treee」來當指令(多一個 e),筆者的環境為 Mac。

▋ 使用 tree 生成樹狀的目錄結構
下面分享幾個高頻率使用的指令:
tree
: 顯示「資料夾」與「目錄」

tree -d
: 僅顯示「資料夾」

tree -l n
: 顯示到第 n 層目錄(tree -l 2 就是顯示兩層目錄)

tree --ignore pattern
: 排除不要顯示的檔案/資料夾(tree --ignore node_modules 就能排除 node_modules 資料夾)

tree -o filename
: 將結果寫入 filename 這個檔案
這邊展示一個組合指令: tree --ignore node_modules -l 3 -d > README.md
這個指令能將 3 層目錄資料夾(排除 node_modules)結果寫入 README.md 這個檔案中。
一開始生成好後,README.md 的預覽會因為沒有排版導致難以閱讀。

但只要在開頭和結尾加上「```」就會排版嚕!

以上就是這篇文章的分享,希望這個套件能幫助大家更輕鬆、清晰的撰寫與表達文件。
如果這篇文章對你有幫助,可以對文章拍手讓我知道 👏🏻,也歡迎點擊「Follow」來追蹤我~
▶︎ 如果這篇文章有幫助到你
1. 可以點擊下方「Follow」來追蹤我~
2. 可以對文章拍手讓我知道 👏🏻
你們的追蹤與鼓勵是我繼續寫作的動力 🙏🏼
▶︎ 如果你對工程師的職涯感到迷茫
1. 也許我在iT邦幫忙發表的系列文可以給你不一樣的觀點 💡
2. 也歡迎您到書局選購支持,透過豐富的案例來重新檢視自己的職涯