快速开始
按官方安装页选择操作系统和架构,再核对实际安装版本。截至 2026 年 10 月 25 日最新稳定标签为 v26.9.1,nightly 是另一条更新路径。文档列出用于类型检测的 file,以及按需安装的辅助工具,例如 jq 预览 JSON、poppler 预览 PDF、ffmpeg 生成视频缩略图。先在自己选的普通目录启动 yazi,熟悉导航后再修改文件;图片预览另按终端协议核对官方指南。
浏览文件时,保留目录上下文
Yazi 是用 Rust 编写的终端文件管理器,适合日常已经在命令行里工作的人。官方功能包括文件预览、多标签、跨目录选择、搜索集成和批量重命名。可以先用它浏览一个项目目录,让文件列表和旁边的预览保持在同一个工作视野,再用自己配置的应用打开文件。
开始时先关注导航和常用文件类型。如果日常经常处理 JSON 或 PDF,先补齐相应预览依赖,再考虑更大的插件组合。主题、Lua 插件和远程文件系统工作流也在官方能力范围内,但各有自己的设置与兼容条件。
预览效果取决于环境
安装指南列出用于文件类型检测的 file。其他辅助工具分别启用部分能力:jq 用于 JSON 预览,poppler 用于 PDF,ffmpeg 用于视频缩略图,fd 或 ripgrep 用于搜索。安装了 Yazi 本体,并不代表这些工具都已经存在。
图片预览还依赖终端协议。官方兼容表区分 Kitty、iTerm2、Sixel 和回退路径,部分终端有版本要求。应核对自己实际使用的终端及多路复用环境,而不是直接把演示里的显示效果当作所有环境的表现。
一条近期的刷新反馈
issue 4443 中,Anor Bertran 描述了 Linux Wayland、foot 1.28.0 和 2026 年 10 月 23 日 nightly commit 40a9142 的使用情况:目录被外部修改后,切回终端焦点可能让可见列表移动,但光标仍停在原文件。其对照是目录没有变化时,单纯切换焦点不会移动列表。截至 10 月 25 日,该问题仍未关闭。
这是特定 nightly 环境下的用户报告,不是 Boloop 亲测,也不是文件丢失报告,更不能证明所有稳定包都如此。当前稳定发布标签 v26.9.1 的日期是 9 月 1 日,而报告中的 nightly 恰好使用相同版本字符串;比较行为时应同时记录实际构建。
如果文件导航已经是你的终端工作流之一,又希望随手查看文件内容,Yazi 值得考虑。项目仍自称公开 beta、处于密集开发中,升级前应核对发行说明和插件兼容性。Boloop 的推荐依据是官方材料和上述署名使用记录,本次没有安装或测量其性能。
资料来源与延伸阅读
- Yazi: features, beta status and terminal compatibility官方资料 · sxyazi and Yazi contributors
- Installation, dependencies and packaging status官方资料 · Yazi contributors
- Stable release v26.9.1官方资料 · sxyazi
- Focus-in directory refresh moves the viewport #4443使用记录 · Anor Bertran
- Yazi MIT copyright and permission notice官方资料 · sxyazi