如果你还在用cd加ls再配上上下左右方向键在终端里扒拉文件我强烈建议你花十分钟试试 yazi。我第一次在 GitHub 上刷到这个项目的时候说实话有点不以为然——终端里的文件管理器又不是什么稀罕物ranger 我断断续续用了好多年nnn、lf 也折腾过但 yazi 确实让我把文件操作的习惯彻底换掉了。yazi 的核心体验就三个字快、顺、全。它用 Rust 写、基于异步 I/O复制文件不卡界面大目录秒进图片和文本都能在终端里直接预览。最关键的是它的按键逻辑对 Vim 用户非常友好基本不用重新背一套键位。如果你和我一样经常 SSH 上服务器干活在 Neovim 里写代码或者就是喜欢两手不离键盘那种操控感这篇文章值得你花几分钟看完。我会从需求讲起覆盖 Linux、macOS、Windows 三套环境的安装配置然后讲日常使用工作流最后给自己踩过的坑做一个完整的记录。内容尽量做到有手就能复制但也有一些配置细节是官方文档里不写明白的我会单独拿出来强调。1. 为什么我从传统终端操作切到了 yazi1.1 终端里翻文件的老办法有多难受先说个场景你 SSH 到一台服务器上要找一个日志文件位置大概是/var/log/nginx/某个子目录下但你不确定是access.log还是error.log.20240615.gz需要翻一翻。传统做法是什么先cd /var/log/nginx再ls -lah看一圈没有就用find按名字搜或者grep直接搜内容路径深一点还要不断cd ..来回切。这套组合拳用习惯了倒也不是不能用。但问题在于它把“浏览文件”和“查看文件内容”这两位操作割裂开了。你想看一个文件得先打开它cat、less、vim不想看了退出来再继续翻下一个文件。连续翻十几个文件的时候效率掉得很厉害。而且ls的输出默认没有预览、没有高亮、没有图标信息密度低尤其在目录层级深、文件数量多的生产环境下想快速定位目标文件真的挺折磨人。另外还有一个痛点批量操作。如果你想把这几个文件从一个目录挪到另一个目录传统的做法是把文件名挨个敲进cp或者mv命令里或者现场写一个for循环。临时性的操作不值得写脚本但手工敲又容易出错。终端文件管理器正好解决这一类问题——可视化、光标移动、勾选、批量执行一步到位。1.2 yazi 和 ranger、lf、nnn 的定位差异其实终端文件管理器这个赛道不新ranger 是 Python 写的扩展性强但 Python 启动慢、界面刷新有时候卡顿nnn 很快但功能相对简洁预览能力弱lf 是 Go 写的速度和简洁性都不错可是预览和插件生态都相对基础。yazi 的定位就在它们中间取了一个很好的平衡点底层是 Rust tokio 异步运行时启动速度毫秒级操作反馈几乎无延迟上层设计了完整的预览系统、任务系统和 Lua 插件接口。一句话总结就是它既有 ranger 那种“什么都能干”的野心又有 nnn 级别的轻快响应属于现代终端文件管理器里综合体验最均衡的方案之一。尤其是预览这一块yazi 做得很细。文本文件调用bat高亮图片可以在支持图形协议的终端里直接渲染缩略图视频文件还能抽帧看封面压缩包能直接列出内容。这些能力让它的适用范围不只是“服务器上应急用”完全可以当作日常的主力文件管理器来使。2. yazi 的核心设计异步、预览、插件三方配合2.1 异步 I/O 为什么是体验的分水岭很多人不知道文件管理器卡顿的根源在哪儿。传统文件管理器在复制大文件或者扫描大目录的时候文件操作如果是同步阻塞的界面就整个冻住鼠标键盘全部失灵只能干等。ranger 这类 Python 脚本在目录项特别多的时候加载会有明显延迟同样跟同步遍历有关系。yazi 的做法是核心用异步任务池去处理这些耗时操作。把任务丢给后台线程去跑界面主循环保持响应你复制几个 GB 的文件时列表还能继续滚动、预览还能继续切换等任务完成之后右下角弹一个通知。这个体验在终端文件管理器里非常少见日常用下来几乎感觉不到“等待”这件事。同样的道理也体现在目录加载上。yazi 进入一个包含上万个文件的目录不会卡住等全量读取而是先显示一部分后台继续补充列表滚动丝滑。对于服务器上日志文件堆积如山的场景这个优势尤其明显。2.2 预览系统依赖一堆外部工具而不是自己闷头造轮子yazi 的预览系统不是把所有能力内置而是“各司其职”地调用外部命令行工具。默认情况下文本预览走bat代码高亮从系统里自动识别文件搜索和内容检索依赖rgripgrep和fd图片预览在不同终端协议下会自适应选择chafa、kitty、ueberzug等方式。这种设计的好处是生态成熟、维护成本低。每个工具都是各自领域的顶配yazi 只需要把它们串起来。坏处就是你需要手动安装这些依赖缺一个对应的预览能力就少一块。不过好在 yazi 对缺失依赖的处理比较宽容缺了也只会影响预览不会导致程序启动失败。视频缩略图默认用ffmpegthumbnailer抽帧PDF 预览用pdftotext抽取文本图片尺寸信息、文件夹内文件数量统计这些自带能力也都有。配置好之后在终端里浏览文件基本能替代 GUI 文件管理器的大部分需求。2.3 Lua 插件系统给高级用户留好了扩展口子yazi 的插件体系基于 Lua控制文件比较薄但自由度不低。你可以通过插件自定义排序规则、自定义状态栏显示内容、增加预览的处理类型甚至实现一些特殊的工作流。官方仓库里就有不少现成插件比如git状态集成、fzf集成等。更实用的是yazi 内置了 package 管理机制一条ya pack -a命令就能从 GitHub 拉取插件到本地类似 Vim 的插件管理器。这个设计很聪明——配置文件留在本地插件依赖集中管理升级和回退都可控。当然如果你只是轻度用户不碰插件也没关系默认体验已经足够好。插件系统更像是一个“能力上限”保证你在成为重度用户之后不用换工具。3. 环境准备与安装Linux、macOS、Windows 全平台实测3.1 Linux 和 macOS多数情况一条命令搞定Linux 下安装 yazi 最直接的方式是走各发行版的包管理器。Arch 系直接sudo pacman -S yaziDebian/Ubuntu 在较新版本里也能直接sudo apt install yaziFedora 用sudo dnf install yazi。macOS 用户装好 Homebrew 之后brew install yazi即可。如果你用的发行版打包版本比较老或者想追新建议通过 cargo 安装cargo install --locked yazi-fm。这条路需要 Rust 工具链第一次编译会比较久我实测在普通配置的电脑上大概要编译 10 到 15 分钟耐心等就行。装上之后yazi --version验证一下。依赖工具方面我建议一条命令全部补齐rg、fd、bat、eza、zoxide这几个属于高频率辅助项。chafa在多数发行版仓库里也有装好之后能在不支持图像协议的终端里用字符画预览图片聊胜于无。3.2 Windowsscoop 一把梭但有几个坑必须提前说最近很多人开始关注 yazi 在 Windows 上的表现我也在 Windows 11 上专门测了一批真实场景。好消息是yazi 官方提供了 Windows 原生支持不再是 WSL 专属坏消息是有一些小坑需要提前知道。Windows 最推荐的方式是scoop install yazi。如果你习惯用 wingetwinget install yazi也能装但 scoop 的版本更新更及时。装完之后需要把rg、fd、bat这几个依赖也用 scoop 装上不然文本预览和搜索能力会缺失。Windows 下最大的坑是终端的图形协议支持。Windows Terminal 目前不支持 Kitty 图像协议所以图片预览默认会显示为字符画或直接关闭。不过对于代码、日志、配置文件这些纯文本场景Windows Terminal 配合 yazi 已经非常顺滑了。另外如果你在 PowerShell 里用 yazi部分自定义 shell 函数的行为跟 bash 下不太一样退出 yazi 后目录切换的实现要自己写。后面第 5 章我会给出具体代码。3.3 依赖工具推荐表装哪些、为什么装下面是个人推荐的依赖清单按“建议装机”到“选装”分档整理。装全之后yazi 的体验是最完整的。工具用途建议等级备注ripgrep (rg)文件内容搜索必装搜索引擎极快自带忽略规则fd文件名搜索必装find 的现代替代语法更友好bat文本预览/高亮必装语法高亮、行号、Git 状态eza增强 ls供插件/主题用推荐跟 yazi 自带列表互补zoxide智能目录跳转推荐配合 yazi 快速切换目录chafa图片字符画预览选装不支持图形协议的终端备选ffmpegthumbnailer视频抽帧预览选装需要预览视频时安装pdftotextPDF 文本预览选装poppler-utils 提供这套依赖在 Linux 上一般仓库都有macOS 用 brew 也能一把装齐。Windows 下统一走 scoop注意ffmpegthumbnailer在 scoop 里叫ffmpegthumbnailer直接搜索即可。4. 配置调优从默认键位到顺手的工作流4.1 配置文件结构和首次初始化yazi 的配置目录在~/.config/yazi/Windows 下是%APPDATA%\yazi\config\。主要有四个文件yazi.toml是主配置管理文件管理器行为keymap.toml管按键映射theme.toml管主题和颜色还有最新的init.lua是 Lua 初始化入口。第一次运行时如果配置目录不存在yazi 会按内置默认配置启动不会自动生成配置文件。很多人卡在这一步——想改配置却不知道去哪里改。解决办法是执行yazi --debug它会输出所有配置文件的绝对路径你按路径创建对应文件即可。我个人的习惯是用yazi.toml只做最小化修改把大部分自定义逻辑放到init.lua里。新版 yazi 的 Lua 入口逐渐成为配置首选有个趋势是未来按键映射和主题也可能迁移到 Lua 体系。4.2 默认键位速查Vim 用户零成本上手yazi 的默认键位高度贴近 Vim 的肌肉记忆。h返回上级目录j/k向下/向上移动l进入目录或打开文件gg回到列表顶部G到底部/可以调出搜索框空格键是选中/取消选中文件y复制选中项p粘贴dd删除。我实际操作中最常用的几个组合f快速过滤输入关键字实时过滤当前目录列表这个比find效率高太多。;调出 shell 输入框在当前目录直接执行命令。空格多次空格可以多选文件之后统一操作。Tab切换左右面板可以方便对比两个目录。[和]在符号链接/真实路径之间跳转这个在查看软链场景很实用。熟记这几个键之后你的目录操作速度大概能提升一个量级。4.3 自定义打开规则让 yazi 知道哪些文件给谁打开默认情况下yazi 对所有文件都会调用系统默认程序这对代码文件很不友好。我建议在yazi.toml里配置[opener]规则把常用类型分配给指定程序。比如我想让.rs、.py、.toml等代码文件默认用 Neovim 打开在[opener]下配置一个规则[opener] edit [ { name nvim, run nvim $, block true, escape true }, ] [open] rules [ { name */, use [ edit ] }, { name *.rs, use [ edit ] }, { name *.py, use [ edit ] }, { name *.toml, use [ edit ] }, { name *.md, use [ edit ] }, ]配置的核心是escape true这个选项意思是当打开文件时yazi 会先退出到 shell 的上下文中把终端控制权交给nvim。等你退出nvim回来还能看到 yazi 保持在你离开的位置。这个“临时退避”机制是终端文件管理器的经典操作能避免嵌套界面带来的混乱。4.4 主题和图标装一个 Nerd Font完整版 yazi 才成立yazi 界面支持文件类型图标但前提是你的终端字体是 Nerd Font。我试过不装 Nerd Font 直接跑 yazi文件列表里全是方框乱码虽然不影响功能但观感大打折扣。解决办法是去 Nerd Fonts 官网下载JetBrainsMono Nerd Font或者FiraCode Nerd Font安装后在终端设置里切换字体。图标之外theme.toml里可以自定义文件类型高亮颜色、状态栏样式、预览区域背景。默认主题足够好看我花了点时间微调了目录高亮色和选中项背景色让它在深色背景下更突出。5. 实操流程我用 yazi 处理文件的一天5.1 完整流程从定位到打开一气呵成我前面说 yazi 把定位和预览合在一起这里用一个完整例子演示。场景我需要找到一个已经部署到服务器上的 Python 脚本确认一下里面的定时任务逻辑然后顺手改一下并发数。进入服务器后执行yazi出现界面分左右两栏左边是目录树右边是文件列表。我直接按f然后输入cron列表里瞬间过滤出所有带 cron 字样的文件。光标落到daily_cron.py上右边预览区域已经用 bat 语法高亮显示了文件开头内容。我确认就是它按l自动用 nvim 打开修改保存退出 nvim 后回到 yazi继续浏览其他目录。整个过程没有一次cd没有一次ls没有打开多个终端窗口。目录层级在这个场景里完全透明了。5.2 多选、批处理、跨目录复制省掉临时脚本另一个高频场景是批量处理文件。之前有一次需要把一个项目里的所有.jpg图片统一移动到一个assets目录数量大概三四十张。用传统方式我得find然后xargs mv临时脚本虽然不复杂但总觉得杀鸡用牛刀。在 yazi 里操作步骤是这样的进入图片所在目录按空格键逐个选中需要的文件或目录选完按y复制再导航到assets目录按p粘贴。整个过程所见即所得选中的文件高亮显示最后复制任务在右下角异步执行界面不卡。而且 yazi 的多选跟剪贴板模式很像支持追加、全选、取消全选等操作。*全选-取消选择空格切换单个选择状态。熟悉之后批量操作完全不需要再写临时命令。5.3 与 Tmux/Zellij 组合浮动窗口里的文件管理器如果你用 Tmuxyazi 有个非常实用的能力它可以作为浮动窗口打开。在.tmux.conf或者 Zellij 的布局里给 yazi 单独开一层浮动窗按快捷键呼出/隐藏。我自己的习惯是按Prefix f呼出一个覆盖在编辑器上方的 yazi 浮动窗口选好文件回车立刻关闭并回到编辑器中用默认规则打开。这个组合的好处是你在写代码的时候不用离开 Neovim 的上下文就能快速浏览项目结构、找文件、预览图片选中之后一切都回到原工作流。相比在 Neovim 内部用:Explore或者nvim-treeyazi 的文件管理能力更强预览和批处理都更专业。6. 常见问题与踩坑记录6.1 图片预览不显示或显示为字符画如果你看到图片预览区域是一堆彩色字符或者干脆空白基本可以确定终端协议和依赖没有对上。检查顺序如下确认chafa已安装并且yazi --debug能识别出来。如果你的终端是 Kitty她会走 Kitty 图形协议需要确认kitty版本足够新。如果是 WezTerm 或 Windows Terminal标准做法是安装chafa并开启字符画预览注意性能消耗较大图片大的时候会卡。实测下来Linux 下用 Kitty 的图片预览体验最完整图片清晰、加载快Windows Terminal 在最新的版本里也在逐步探索图形协议支持但暂时不够稳定。6.2 配置文件修改但不生效yazi 的配置加载跟当前目录是有关系的。修改yazi.toml之后需要重启 yazi 进程才会重新加载。有些版本支持热重载但我建议养成改配置后重启的习惯。另外keymap.toml的格式比较严格少写一个逗号或者缩进不对yazi 会直接忽略这个文件并且不报错。排查方法是执行yazi --debug确认它输出的配置目录是不是你实际修改的那个尤其是 Windows 用户注意区分用户目录和系统目录。6.3 Windows 专属工具栏图标方块、打开方式不对Windows 下图标显示问题九成是 Nerd Font 没装两成是 Windows Terminal 配置文件里还没有把默认字体改成 Nerd Font。两个都做了还不行检查flake8类的占位符是不是被终端字体 fallback 覆盖了。还有一个 Windows 特有的问题yazi 调用系统默认程序时中文文件名或者带空格的路径可能会解析失败。官方方案是在 opener 的 run 命令里加上双引号包裹路径比如run code $。这个配置在 Linux 下不敏感但 Windows 下很关键。6.4 调整完退出 yazi 后目录没切换yazi 本身是独立进程退出后 shell 的当前目录不会自动跟随。官方提供了一个 shell 集成方案在.bashrc或.zshrc里加一段函数把 yazi 作为子 shell 运行并根据退出码决定是否切换目录。我自己的.zshrc里是这样写的function y() { local tmp$(mktemp) yazi $ --cwd-file$tmp if cwd$(cat -- $tmp) [ -n $cwd ] [ $cwd ! $PWD ]; then cd -- $cwd fi rm -f -- $tmp }之后在终端里用y代替yazi退出时就能自动切到上次停留的目录。Windows 的 PowerShell 用户需要写一个类似函数逻辑一样只是语法不同。写在最后我的一些真实体会yazi 目前在终端文件管理器的体验上走得比较前特别是异步架构和预览体系的完整度让我这种从 ranger 时代过来的人有明显感知上的提升。但工具终究是工具真正值钱的是你自己的工作流——yazi 能不能嵌入到你的日常操作里取决于你愿不愿意花一个下午调整配置、磨合键位。我个人的建议是先别急着改配置用默认设置正常使用一周感受一下哪些地方卡手再去动keymap.toml和 opener 规则。随着使用习惯的沉淀你会发现有些键位你根本不需要改有些配置则是反复调优。最后再分享一个小技巧——yazi 的--cwd-file参数是个好东西它让“退出后切换目录”成为可能很多高级 shell 集成都靠它实现不理解的时候多看几遍官方文档里的配置示例比到处搜教程管用得多。
