Broot

產品說明

Broot 是一款以 Rust 撰寫的現代化命令列工具，旨在解決傳統 ls 指令在面對大型目錄時的資訊過載問題。它並非試圖取代 ls，而是提供一種全新的「樹狀概覽」視角，讓你能在不迷失於層層目錄結構的情況下，快速定位檔案。

Broot 最強大的功能在於其「模糊搜尋」（Fuzzy Search）與「自動摺疊」機制。當你開啟一個包含數萬個檔案的專案目錄時，Broot 會自動篩選並顯示最相關的結構，讓你一眼看清全貌。透過簡單的鍵盤輸入，你可以即時過濾樹狀結構，並直接預覽檔案內容或執行移動、複製等操作。

核心特色：

• 智慧樹狀視圖：自動調整顯示層級，即使在龐大的目錄下也能保持畫面簡潔，不會像 tree 指令一樣被大量檔案淹沒。
• 模糊搜尋導航：無需輸入完整檔名，僅需鍵入關鍵字，樹狀結構便會即時過濾，讓你極速找到目標檔案。
• 無縫 Shell 整合：透過 br 函式，當你在 Broot 中進入某個目錄並離開後，你的 Shell 會自動切換到該目錄（解決了傳統 Subshell 無法改變父行程路徑的問題）。
• 強大的預覽功能：支援在終端機內直接預覽文字檔、Git 狀態，甚至是圖片（需配合支援 Kitty 協定的終端機）。
• 磁碟空間分析：輸入 :sizes 指令，即可切換為磁碟占用模式，其速度與效能媲美 ncdu。

安裝指南

Broot 支援多種作業系統與安裝方式。

macOS (Homebrew)

brew install broot

Linux (使用 Cargo, 需安裝 Rust 環境)

cargo install broot

Linux (Ubuntu/Debian)
自較新版本的倉庫中可能已包含，或下載官方二進位檔：

# 下載 x86_64-linux 二進位檔並賦予執行權限
wget [https://dystroy.org/broot/download/x86_64-linux/broot](https://dystroy.org/broot/download/x86_64-linux/broot)
chmod +x broot
sudo mv broot /usr/local/bin/

Windows (Scoop)

scoop install broot

⚠️ 關鍵步驟：Shell 整合
安裝完成後，為了啟用「切換目錄」功能，請務必執行以下指令來自動設定 Shell 設定檔（支援 bash, zsh, fish）：

broot --install

之後請重新啟動終端機，並使用 br 指令來啟動 Broot。

使用教學

啟動 Broot 非常簡單，只需在終端機輸入 br（而非 broot）：

br

1. 基礎導航與搜尋

• 鍵入文字：直接開始打字，Broot 會進入搜尋模式，即時過濾顯示符合的檔案或目錄。
• Enter：
  • 若選取的是檔案：使用系統預設程式開啟（或進入編輯模式）。
  • 若選取的是目錄：進入該目錄並以其為新的根節點顯示。
• Alt + Enter：選取目標目錄後按下，Broot 會結束執行，並讓你的 Shell 停留在該目錄（這是 br 的精隨）。
• Esc：清除搜尋內容，或離開 Broot。

2. 常用操作指令

Broot 採用類似 Vim 的 : 冒號指令模式：

• :sizes (或是切換開關)：顯示檔案與目錄的大小佔用，協助清理磁碟空間。
• :date：顯示檔案修改時間。
• :perm：顯示檔案權限。
• :git_status (或 :gf)：顯示 Git 修改狀態，快速查看哪些檔案有變更。

3. 進階雙面板操作

• Ctrl + →：開啟右側預覽面板（Preview Panel）。若選取的是目錄，則會開啟另一個瀏覽面板。
• Ctrl + ←：回到左側面板。
• Tab：在面板或搜尋結果間切換。

4. 檔案管理

你可以在搜尋到檔案後直接進行操作，例如複製或移動：

1. 選取檔案。
2. 輸入 :cp <目的地> 進行複製。
3. 輸入 :mv <目的地> 進行移動。