Home Manager中Yazi配置TOML数组的正确写法

在使用Home Manager配置Yazi文件管理器时，许多用户遇到了TOML数组格式配置的难题。特别是当需要为Yazi插件配置多个前置fetcher时，标准的Nix语法与TOML格式之间的转换容易产生混淆。

问题背景

Yazi的插件系统允许用户通过yazi.toml配置文件定义多个前置fetcher。例如Git插件需要配置两个不同的fetcher条目：一个用于普通文件(name = "*")，另一个用于目录(name = "*/")。在原生TOML中，这需要写成双重方括号的数组格式。

常见错误配置

许多用户尝试以下配置方式但都失败了：

1. 直接嵌套写法：

settings = {
    plugin.prepend_fetchers = {
        id = "git";
        name = "*";
        run = "git";
    };
};

这种写法生成的TOML会缺少一层数组括号。

2. 字符串键名写法：

settings."plugin.prepend_fetchers" = ...

这会导致生成不正确的TOML数组格式。

正确解决方案

经过社区验证，正确的Nix配置方式应该是使用Nix列表语法来对应TOML的数组结构：

settings = {
    plugin.prepend_fetchers = [
        {
            id = "git";
            name = "*";
            run = "git";
        }
        {
            id = "git";
            name = "*/";
            run = "git";
        }
    ];
};

这种写法会被正确转换为TOML格式的双重方括号数组：

[[plugin.prepend_fetchers]]
id = "git"
name = "*"
run = "git"

[[plugin.prepend_fetchers]]
id = "git"
name = "*/"
run = "git"

技术原理

这种转换工作的原理在于：

1. Nix中的列表类型([...])会被转换为TOML中的数组
2. 每个列表项中的属性集({...})会成为TOML数组中的一个元素
3. Home Manager的TOML生成器会自动处理嵌套结构的转换

对于更复杂的插件配置，如同时配置Git和MIME类型检测，可以继续在列表中添加更多配置项：

settings = {
    plugin.prepend_fetchers = [
        # Git配置
        {
            id = "git";
            name = "*";
            run = "git";
        }
        {
            id = "git";
            name = "*/";
            run = "git";
        }
        # MIME类型检测
        {
            id = "mime";
            name = "*";
            run = "mime-ext";
            prio = "high";
        }
    ];
};

总结

通过理解Nix与TOML格式之间的对应关系，特别是列表与数组的转换规则，可以避免Yazi配置中的常见陷阱。记住关键点：在Nix中使用列表来表示TOML中的数组结构，每个列表项对应一个TOML数组元素。这种方法不仅适用于Yazi的插件配置，也适用于其他需要复杂TOML结构的应用场景。