在日常開發和管理文件時，我們常常需要快速查看目錄結構，尤其是處理 Hugo、WordPress 或其他靜態站點項目時，目錄層級複雜，很容易迷路。macOS 系統自帶的 Finder 可以圖形化查看文件，但在終端中以樹狀結構查看目錄更直觀、更方便導出。本文將介紹如何在 Mac 上使用 tree 命令來輸出目錄結構，並分享一些實用技巧。

1️、安裝 tree

macOS 默認沒有安裝 tree 命令，但可以通過 Homebrew 快速安裝：

brew install tree

安裝完成後，在終端輸入 tree 就可以使用了。

2️、基本用法

進入你想查看的目錄，例如 Hugo 項目的 content 目錄，然後運行：

tree

輸出示例：

.
├── de
│   ├── article
│   ├── categories
│   └── tags
├── en
│   ├── article
│   ├── categories
│   └── tags
└── fr
    ├── article
    ├── categories
    └── tags

從上面的輸出可以清楚地看到項目的多語言目錄結構，每個一級目錄就是一個語言版本。

3️、常用參數

tree 命令提供了很多實用選項，可以幫助你定製輸出：

  • 顯示指定層級
tree -L 2

表示只顯示兩層目錄，避免目錄太深時輸出過長。

  • 顯示隱藏文件
tree -a

會列出以 . 開頭的隱藏文件，例如 .git。

  • 只顯示目錄
tree -d

只輸出目錄層級，不顯示文件。

  • 忽略某些目錄
tree -I "node_modules|public"

忽略項目中的 node_modules 和 public 目錄，輸出更清爽。

4️、導出目錄結構到文件

有時候我們需要把目錄結構分享給同事或記錄文檔，可以將輸出保存到文本文件：

tree -L 4 > structure.txt

或者忽略不必要的文件夾：

tree -L 4 -I "node_modules|public|resources" > structure.txt

這樣就可以生成一個漂亮的目錄樹文本，便於發送或歸檔。

5️、Hugo 項目實用示例

以 Hugo 新聞站為例，項目 content 目錄多語言結構可能如下：

content/
├── de
│   ├── article
│   ├── categories
│   └── tags
├── en
│   ├── article
│   ├── categories
│   └── tags
└── fr
    ├── article
    ├── categories
    └── tags

使用命令：

tree -L 3 content

即可快速查看每個語言下的文章、分類和標籤目錄，非常直觀。

6️、小技巧

  • 配合 grep 搜索文件類型
tree -f | grep ".md"

可以列出項目中所有 Markdown 文件。

  • 美化輸出 安裝 tree 後，終端中可以使用彩色輸出：
tree -C
  • 結合 Hugo 自動化 在 Hugo 項目中，可以把目錄結構輸出作為文檔説明或 sitemap 輔助文件。

總結

tree 命令是 Mac 終端中非常實用的工具，尤其在處理多語言 Hugo 項目、博客、網站開發時，可以快速查看目錄結構、導出目錄、排查問題。掌握一些參數，還能提升工作效率，讓你對項目結構一目瞭然。