The Back of Daniel

首頁
iTerm2

【macOS 終端機神器】Yazi：極速 Rust 檔案管理器介紹與 iTerm2 圖示顯示「?」疑難雜症排除指南

Yazi Terminal File Manager on macOS

如果你習慣在 macOS 的終端機（Terminal）環境中工作，一定體驗過在命令列層層 cd 與 ls 的繁瑣過程。雖然傳統的 ranger、nnn 或 lf 提供了終端機檔案管理的功能，但在處理大資料夾、圖片預覽或非同步載入時，總覺得少了些流暢感。

近期在開源社群極具話題性的 Yazi（Rust 撰寫的 terminal file manager），憑藉其驚人的執行速度與現代化的介面體驗，迅速成為許多 Vim / Neovim 玩家與 CLI 愛好者的首選。

本文將為大家介紹 Yazi 的核心亮點，並針對在 macOS iTerm2 / Terminal 中最常見的「圖示變問號 ?」問題提供一鍵解決方案！

🚀 為什麼選擇 Yazi？四大核心亮點

1. ⚡️ 極速非同步架構 (Rust + Tokio)

Yazi 完全採用 Rust 開發，並基於 Tokio 非同步框架。無論是展開包含上萬個檔案的資料夾、做即時搜尋，或是檔案預覽，過程都是零延遲、不卡頓。

2. 🖼️ 原生圖片與媒體預覽

傳統 TUI 檔案管理器最難搞定的就是圖片與 PDF 預覽。Yazi 原生支援 Kitty、WezTerm、iTerm2 的 Inline Image protocol 以及 chafa / ueberzugpp，連 PDF、影片縮圖都能直接在終端機內完美呈現！

3. ⌨️ Vim 式鍵盤流操作

Yazi 的預設快捷鍵非常符合 Vim 使用者習慣：

  • h / j / k / l ：切換父目錄、下移、上移、進入子目錄
  • space ：標記選取檔案
  • g ：快速跳轉（如 g h 到家目錄，g d 到 Downloads）
  • q ：離開

4. 🌿 Git 狀態整合

檔案清單旁會即時標示 Git 修改狀態（Untracked, Modified, Staged），讓你在 CLI 瀏覽專案時一目了然。

❓ 實戰踩坑：為什麼 Yazi 在 iTerm2 中滿滿都是 `?` 問號？

許多初次在 macOS iTerm2 或 Terminal.app 安裝並啟動 yazi 的朋友，第一眼看到畫面時都會大吃一驚——怎麼資料夾、檔案與 Git 圖示全都變成 ? 或正方形問號塊？

原因分析

yazi 在介面中大量使用了 Nerd Fonts 的特殊 Icon 符號（包含資料夾圖示 📁、程式語言副檔名標誌 🐍🦀、Git 狀態符號等）。當你終端機目前設定的字型不包含這些 Nerd Fonts 特殊符號集時，作業系統無法渲染，就會預設退回到顯示 ? 或缺字方塊。

💡 3 步驟完美解決 Yazi 問號 `?` 問題

解決方法非常簡單，只需要安裝並設定支援 Nerd Fonts 的字型即可：

步驟 1：安裝 Nerd Font

建議透過 macOS 的 Homebrew 直接安裝熱門且好看的 JetBrains Mono Nerd Font：

brew install --cask font-jetbrains-mono-nerd-font
💡 備註：若未安裝 Homebrew，亦可直接前往 [Nerd Fonts 官網下載頁面](https://www.nerdfonts.com/font-downloads) 下載 JetBrainsMono.zip，解壓縮後雙擊 .ttf / .otf 檔案安裝至 macOS 的「字型簿 (Font Book)」。

步驟 2：在終端機中套用字型

字型安裝完成後，開啟您使用的終端機軟體設定畫面進行切換：

1. iTerm2：

  • 按 Cmd + , 開啟 Preferences ➜ Profiles ➜ Text
  • 將 Font 欄位切換為 JetBrainsMono Nerd Font（或 JetBrainsMonoNF-Regular）

    • 2. macOS 預設 Terminal：

  • 按 Cmd + , 開啟 偏好設定 ➜ 描述檔 (Profiles) ➜ 文字 (Text)
  • 點擊字型 變更 (Change)，選擇 JetBrainsMono Nerd Font

    • 3. 現代終端機 (Ghostty / Warp / WezTerm / Kitty)：

  • 在其設定檔（如 ~/.config/ghostty/config 或 wezterm.lua）中指定：

```toml

font-family = "JetBrainsMono Nerd Font"

```

步驟 3：重啟終端機與 Yazi

將終端機完全關閉（Cmd + Q）後重新開啟，再次於終端機輸入：

yazi

此時所有原本顯示為 ? 的問號都會瞬間恢復成精緻好看的圖示與高顏值介面！

🛠️ macOS 上的 Yazi 完整安裝推薦

想發揮 Yazi 100% 的威力，推薦一次把相關的預覽工具套件補齊：

brew install yazi ffmpeg poppler fd ripgrep fzf zoxide imagemagick
  • fd: 快速搜尋檔案
  • ripgrep: 檔案內容快速搜尋
  • fzf: 模糊搜尋整合
  • zoxide: 智慧型目錄快速跳轉 (z)
  • imagemagick / poppler / ffmpeg: 圖片、PDF、影片縮圖預覽

📝 總結

Yazi 絕對是近年 CLI 工具中令人驚艷的佳作。流暢的操作、非同步的效能以及優雅的介面設計，大幅提升了終端機檔案管理的效率。如果之前因為圖示顯示 ? 而感到困擾，趕快補上 JetBrains Mono Nerd Font，享受極速檔案管理的樂趣吧！