配置

Yazi 有三个配置文件：

你可以在 shipped tag 中找到默认配置文件： https://github.com/sxyazi/yazi/tree/shipped/yazi-config/preset

如果你想覆盖任意默认配置，首先需要将上方目录中对应的文件创建到以下位置：

  • Unix-like 系统：~/.config/yazi/
  • Windows：%AppData%\yazi\config\

例如，如果你想修改隐藏文件的显示状态，可以先创建一个 yazi.toml 文件到：

  • Unix-like 系统：~/.config/yazi/yazi.toml
  • Windows：%AppData%\yazi\config\yazi.toml

然后把所需的配置项复制进去。下面是 show_hidden 的示例：

  1. # yazi.toml
  2. [mgr]
  3. show_hidden = true

Yazi 在 release 中已经内置了这些默认配置，因此你不需要复制整个文件，除非你想完全覆盖默认配置。

配置混合

你配置文件中的选项会覆盖默认值。不过对于快捷键，如果你不想直接整体覆盖默认配置：

  1. # keymap.toml
  2. [mgr]
  3. keymap = [
  4.     # ...
  5. ]

而是想在默认快捷键基础上进行自定义，可以使用 prepend_* 或 append_*，把你的配置追加到默认项之前或之后（详见 keymap.toml）：

  1. # keymap.toml
  2. [mgr]
  3. prepend_keymap = [
  4.     # ...
  5. ]
  6. append_keymap = [
  7.     # ...
  8. ]

这种方式同样适用于 open、icon、previewer 和 preloader 规则。

自定义配置目录

你可以通过导出 YAZI_CONFIG_HOME 环境变量来修改 Yazi 的配置目录。例如：

  1. YAZI_CONFIG_HOME=~/.config/yazi-alt yazi

这会使用 ~/.config/yazi-alt 作为配置目录启动 Yazi，并且该目录下可以拥有自己独立的 yazi.toml、keymap.toml、init.lua 等文件。