命令行工具
sxyazi/yazi avatar
sxyazi/yazi

Yazi:终端里的异步文件管理器

💥 用 Rust 编写的基于异步 I/O 的超快终端文件管理器。

42,202 个 Star1,018 个 ForkRustMIT

秒懂

它是什么?
Yazi 用 Rust 构建异步、可扩展的终端文件管理体验,能力高度依赖终端图像协议、外部工具和插件生态。
适合谁用?
适合需要Yazi README 将它定位为基并能接受项目当前边界的团队,不适合把 README 的自报能力直接当成生产保证的团队。先验证 预览能力覆盖代码、目录、视频、PDF 和归档等内容。
能商用吗?
可以。MIT 是宽松许可证:你可以使用、修改并销售基于它的软件,只需保留版权和许可证声明。
还在维护吗?
在维护。仓库在最近一天内有新的提交。
用什么语言写的?
主要是 Rust(依据 GitHub 的语言统计)。

以上回答依据项目的 GitHub 数据(最近同步于 2026年9月15日)和我们的分析,不构成法律意见。

开源项目深度解析

异步终端界面的核心

sxyazi/yazi:项目的入口不是一个抽象口号,而是 README 明确写出的工作对象。Yazi README 将它定位为基于 Rust、异步、非阻塞的终端文件管理器。它支持 Vim 风格导航和操作,目标是让文件选择、预览与批处理在终端内完成。 预览能力覆盖代码、目录、视频、PDF 和归档等内容。图像显示依赖终端协议:kitty、iTerm2、WezTerm、Sixel 终端等有不同支持,无法把某一终端的效果直接推给全部环境。 这决定了读者应先把它放进哪一种问题里:是构建界面、处理文件、识别图像、编排任务,还是观察模型调用。若需求超出这条边界,仓库的星标和项目描述都不能替代功能验证。

sxyazi/yazi:从实际使用角度看,最有价值的是把 README 的名词映射到一个小输入和一个可观察输出。输入、配置、产物和失败信息都应单独记录。这样得到的是针对 yazi 的判断,而不是一段脱离版本的宣传摘要。

sxyazi/yazi:yazi README 的另一项具体线索是:项目集成 ripgrep、fd、fzf 和 zoxide,并提供包管理器安装插件和主题。插件与主题可以更新或固定版本,配置中应记录所装插件,因为它们会改变快捷键、预览和文件操作行为。 这项线索应和前面的输入输出一起记录,避免把单一演示扩大成对全部场景的判断。

预览协议不是同一个东西

sxyazi/yazi:项目集成 ripgrep、fd、fzf 和 zoxide,并提供包管理器安装插件和主题。插件与主题可以更新或固定版本,配置中应记录所装插件,因为它们会改变快捷键、预览和文件操作行为。 这部分说明了项目的主要工作路径。README 能证明的是接口、命令或组件被项目方列出,并不能证明每个平台或每种负载都具有相同表现。尤其涉及自报数字、兼容比例或支持数量时,应把它们视为项目方口径。

sxyazi/yazi:对采用者来说,先固定版本和输入更有意义。用一个能代表业务的最小案例检查输出是否符合预期,再检查错误是否能被定位。文档未说明的默认值、资源上限和兼容组合,不应在选型记录中写成已确认能力。

sxyazi/yazi:yazi README 的另一项具体线索是:README 列出多标签、跨目录选择、可滚动预览、批量重命名、归档解压、视觉模式、垃圾桶、拖放和 Git 集成。它还描述基于 Lua 的发布订阅模型、跨实例通信与状态持久化。 这项线索应和前面的输入输出一起记录,避免把单一演示扩大成对全部场景的判断。

插件和 Lua 扩展面

sxyazi/yazi:README 列出多标签、跨目录选择、可滚动预览、批量重命名、归档解压、视觉模式、垃圾桶、拖放和 Git 集成。它还描述基于 Lua 的发布订阅模型、跨实例通信与状态持久化。 是这套工具真正影响日常流程的地方。它把某些原本分散的动作放到了同一条链路中,但每个动作仍有自己的前置条件。例如终端预览需要协议,OCR 需要语言数据,工作流需要执行器,模型评估需要记录上下文。

sxyazi/yazi:因此,验证不应只停在“命令成功”或“页面打开”。应观察中间产物、日志、时间戳、生成文件、任务状态或评估记录。若只看最终结果,很容易把外部服务、缓存、插件或默认配置造成的效果误认为项目本身的稳定能力。

sxyazi/yazi:yazi README 的另一项具体线索是:桌面窗口系统没有合适图像协议时,可以使用 Überzug++;ASCII 图像回退需要 Chafa 1.16 或更高版本。安装 Yazi 后,首先应在目标终端打开包含图片、视频和归档的目录,分别确认预览与回退表现。 这项线索应和前面的输入输出一起记录,避免把单一演示扩大成对全部场景的判断。

批量操作的风险半径

sxyazi/yazi:桌面窗口系统没有合适图像协议时,可以使用 Überzug++;ASCII 图像回退需要 Chafa 1.16 或更高版本。安装 Yazi 后,首先应在目标终端打开包含图片、视频和归档的目录,分别确认预览与回退表现。 展示了项目和周边系统的连接方式。README 列出的集成可以帮助缩短第一次试用,但连接外部服务也会引入权限、版本和数据流问题。当前素材没有为所有组合提供兼容矩阵,也没有承诺统一的服务等级。

sxyazi/yazi:对团队部署而言,应把连接点写进运行清单:需要哪些凭据,哪些目录会写入,哪个端口会暴露,失败后能否重试或恢复,升级后哪些配置需要重看。对于 yazi,这些问题比“功能很多”更能决定维护成本。

sxyazi/yazi:yazi README 的另一项具体线索是:项目状态标为 Public beta,可作为日常驱动,但 README 同时提醒开发很活跃并预期会有破坏性变更。许可证为 MIT。对于脚本化批量操作,应先用测试目录和垃圾桶路径确认删除、重命名及归档行为。 这项线索应和前面的输入输出一起记录,避免把单一演示扩大成对全部场景的判断。

Public beta 的维护信号

sxyazi/yazi:项目状态标为 Public beta,可作为日常驱动,但 README 同时提醒开发很活跃并预期会有破坏性变更。许可证为 MIT。对于脚本化批量操作,应先用测试目录和垃圾桶路径确认删除、重命名及归档行为。 给出了最需要认真对待的限制。许可证只说明代码使用条件,不等于安全审查、性能验收或数据处理承诺已经完成。项目状态、平台标签和 README 的自报信息也都应与自己的环境分开记录。

sxyazi/yazi:适合它的人,是能接受上述前置条件,并愿意围绕具体输入建立验收样本的人。不适合的人,是需要文档已经替自己承诺全部平台、所有格式或长期稳定性的团队。这个区分能避免把一次成功演示直接升级为生产结论。

sxyazi/yazi:yazi README 的另一项具体线索是:Yazi README 将它定位为基于 Rust、异步、非阻塞的终端文件管理器。它支持 Vim 风格导航和操作,目标是让文件选择、预览与批处理在终端内完成。 这项线索应和前面的输入输出一起记录,避免把单一演示扩大成对全部场景的判断。

在目标终端建立验收样本

sxyazi/yazi:第一次核验可以围绕 yazi 的最小路径展开:预览能力覆盖代码、目录、视频、PDF 和归档等内容。图像显示依赖终端协议:kitty、iTerm2、WezTerm、Sixel 终端等有不同支持,无法把某一终端的效果直接推给全部环境。 先在隔离目录或测试账户中执行,保存命令输出和生成物;随后用第二个边界样本检查失败行为,再重启或重新运行确认状态是否保留。桌面窗口系统没有合适图像协议时,可以使用 Überzug++;ASCII 图像回退需要 Chafa 1.16 或更高版本。安装 Yazi 后,首先应在目标终端打开包含图片、视频和归档的目录,分别确认预览与回退表现。 中提到的外部连接、数据目录或版本入口,应作为观察点。

sxyazi/yazi:针对 yazi,结论应落在具体决定上:谁使用、处理什么输入、接受哪种输出、哪些条件尚未满足。若是 Flutter,就比较同一 Widget 在目标平台的渲染和热重载状态;若是 Perry,就核对编译产物与 Node 模块;若是 Tesseract,就比较 traineddata 和输出格式;若是 claude-video,就保存帧与转录;若是 TruLens,就留存反馈记录;若是 Memos 或 NoteGen,就检查文件与索引;若是 Yazi,就测试终端协议;若是 Airflow 或 Kestra,就观察调度状态与任务产物。先验证这一小段路径,再决定是否扩展到多平台、批量数据、生产调度或长期存储。

sxyazi/yazi:yazi README 的另一项具体线索是:预览能力覆盖代码、目录、视频、PDF 和归档等内容。图像显示依赖终端协议:kitty、iTerm2、WezTerm、Sixel 终端等有不同支持,无法把某一终端的效果直接推给全部环境。 这项线索应和前面的输入输出一起记录,避免把单一演示扩大成对全部场景的判断。

编辑结论

适合需要Yazi README 将它定位为基并能接受项目当前边界的团队,不适合把 README 的自报能力直接当成生产保证的团队。先验证 预览能力覆盖代码、目录、视频、PDF 和归档等内容。图像显示依赖终端协议:kitty、iT,同时观察真实输入、错误日志、生成物和重启后的状态,再决定是否扩大部署范围。

官方来源

  1. Official documentation
  2. Official README
  3. Project repository
  4. Release notes
社区笔记

社区笔记