我查了 Yazi 官方文档。截至目前，官方文档显示的版本为 26.9.1，macOS 推荐使用 Homebrew 安装。结合你的 Mac M4、iTerm2 和 zsh 环境，我建议先安装核心工具，再按需要补齐预览依赖，不要一开始就安装所有可选组件。

一、安装 Yazi

1. 安装核心程序和常用依赖

在 iTerm2 中执行：

brew update
brew install yazi fd ripgrep fzf zoxide jq poppler

这些工具的用途如下：

工具 用途
yazi 文件管理器
fd 文件名搜索，Yazi 按 s 搜索时使用
ripgrep（rg） 搜索文件内容，Yazi 按 S 搜索时使用
fzf 交互式模糊搜索、快速跳转
zoxide 根据访问历史快速跳转目录
jq JSON 文件预览
poppler PDF 预览所需工具

Yazi 的核心依赖很少，其他工具主要是为搜索、预览和导航增加功能。

安装完成后验证：

yazi --version
fd --version
rg --version
fzf --version

直接运行：

yazi

就能打开文件管理器。按 q 退出，按 F1 或 ~ 查看帮助。

2. 按需增加预览能力

如果你还希望预览视频、压缩包和 SVG 图片，再安装：

brew install ffmpeg-full sevenzip resvg

如果需要支持更多图片格式，例如 HEIC、JPEG XL 等，再考虑：

brew install imagemagick-full

Yazi 官方也列出了这些可选依赖。