
爆肝讀程式碼讀到眼神死?這免費工具直接幫你畫出專案結構圖!
你是不是也有過那種痛苦的時刻——剛接手一個 GitHub 專案,打開之後滿滿的 .ts
、.js
、.json
、src
、lib
、utils
…整個資料夾看起來像迷宮,根本不知道從哪裡開始下手?我以前還真的會手動一個個打開看,邊開邊碎念:「這誰寫的啦!怎麼這麼亂啦!」結果搞了三小時才搞懂原來最重要的檔案藏在 core/internal/logic/legacy/
裡面(?)
然後某次,我朋友突然甩了一個連結給我:「你怎麼不用 GitDiagram?」
蛤?那是什麼神秘東西。
結果我點進去一用之後,整個人生變得不一樣了。
這工具有夠猛,它可以幫你把 GitHub 上的 repo 變成一張「可點擊的專案架構圖」,不是唬爛的那種流程圖,是那種真・可以點進去看原始碼的圖。整個畫面有夠直觀,像我這種記路白癡都瞬間搞懂專案長什麼樣子。
我拿我最近剛接的一個專案來測試,那個專案本來光 src/
裡面就有 30 多個資料夾,還分什麼 features
、shared
、entities
、widgets
……我看到都快失明。結果用 GitDiagram 轉出來之後,每個目錄結構都畫得乾乾淨淨,還自動幫我展開重要的檔案,我只要點一下就可以直接進去對應的 GitHub 原始碼頁面,不用再手動在 repo 裡找得要死要活。
而且你知道最爽的是什麼嗎?它不需要你安裝什麼有的沒的!你只要貼一個 GitHub repo 的網址,它就幫你處理好了(當然私有 repo 要給它權限,但公開的直接爽用)。不用 clone,不用跑本機環境,連 VS Code 都可以先放一邊,整個省下超多時間。
對我來說最有幫助的場景有幾種:
- 剛接一個新專案(尤其是別人交接的那種亂七八糟的)
- 要做 code review,但是你根本不熟這個 repo
- 想快速理解一個大型開源專案的架構(比如 React、Next.js 這種)
- 想幫團隊做技術導覽,不想畫一堆圖說明
像我們團隊有個 intern 就說過,他剛開始每天都在用 GitDiagram 看不同專案的結構,搞得他現在講話都很有條理(也太誇張 XD)
不過我覺得最厲害的是,它不只是幫你看架構,還能讓你「建立架構的感覺」。就像你在讀一本小說,從目錄開始先理解故事大綱,再慢慢進入章節內容。你會知道哪些是主幹,哪些是枝節,哪些是作者寫來裝酷的(喂)
說真的,如果這工具早幾年就出現,我應該可以少掉很多半夜加班畫系統架構圖的痛苦。那時候還在 Notion 上畫框框、拉線,畫得自己都看不懂(然後主管還說我畫得「很有藝術感」……你是來搞笑的嗎?)
如果你也是那種只想專心理解專案、不要再浪費時間搞不清楚資料夾的人,我真的很推你用用看 GitDiagram。超直觀、超省腦、超級爽。
記得分享給團隊裡那個最常迷路在 repo 裡的同事,他會感謝你的 ❤️