覆层

覆层(Overlays)作为各种定义(自定义命令、别名、环境变量)的"层",可以根据需要激活和停用。 它们类似于某些语言中的虚拟环境,如 Python。

注意:要了解覆层,请确保先查看 模块,因为覆层是建立在模块之上的。

基础

首先,Nushell 有一个默认的覆层,叫做 zero。 你可以用 overlay list 命令检查哪些覆层是活动的。 你应该可以看到默认的覆层显示在那里。

要创建一个新的覆层,你首先需要一个模块:

> module spam {
    export def foo [] {
        "foo"
    }

    export alias bar = "bar"

    export env BAZ {
        "baz"
    }
}

我们将在本章中使用这个模块。每当你看到 overlay use spam,就应该知道 spam 是指这个模块。

要创建覆层,请调用 overlay use

> overlay use spam

> foo
foo

> bar
bar

> $env.BAZ
baz

> overlay list
───┬──────
 0  zero
 1  spam
───┴──────

在下面的章节中,> 的提示语前面会有最后一个活动覆层的名称。 (spam)> some-command 表示当输入命令时,spam 覆层是最后活动的覆层。

移除覆层

如果你不再需要叠加定义,请调用 overlay hide

(spam)> overlay hide spam

(zero)> foo
Error: Can't run executable...

(zero)> overlay list
───┬──────
 0 │ zero
───┴──────

覆层也是有作用域的。 任何添加的覆层都会在作用域结束时被移除:

(zero)> do { overlay use spam; foo }
foo

(zero)> overlay list
───┬──────
 0  zero
───┴──────

此外,overlay hide 在没有参数的情况下,将删除最后一个活动的覆层。

覆层是可记录的

任何新的定义(命令、别名、环境变量)都会被记录到最后一个活动的覆层:

(zero)> overlay use spam

(spam)> def eggs [] { "eggs" }

现在,eggs 命令属于 spam 覆层。 如果我们删除该覆层,我们就不能再调用它:

(spam)> overlay hide spam

(zero)> eggs
Error: Can't run executable...

但是,我们可以把它找回来!

(zero)> overlay use spam

(spam)> eggs
eggs

覆层会记住你所添加的内容,即使你删除了它们,也会储存这些信息。 这可以让你在不同的上下文中反复切换。

TIP

有时,在添加一个覆层后,你可能不希望自定义对象被添加到其中。 解决的办法是创建一个新的空的覆层,只用来记录自定义的变化:

(zero)> overlay use spam

(spam)> module scratchpad { }

(spam)> overlay use scratchpad

(scratchpad)> def eggs [] { "eggs" }

eggs 命令被添加到 scratchpad 中,同时保持 spam 不变。

0.64 版本新增: 为了让上述步骤不那么冗长,你可以使用 overlay new 命令:

(zero)> overlay use spam

(spam)> overlay new scratchpad

(scratchpad)> def eggs [] { "eggs" }

保存定义

有时,你可能想删除一个覆层,但保留所有你添加的自定义定义,而不必在下一个活动覆层中重新定义它们:

(zero)> overlay use spam

(spam)> def eggs [] { "eggs" }

(spam)> overlay hide --keep-custom spam

(zero)> eggs
eggs

--keep-custom 标志正是用来做这个的。

覆层顺序

覆层被排成一个堆栈。 如果多个覆层包含相同的定义,比如 foo,最后一个活动的覆层将优先。 要把某个覆层放到堆栈的顶部,你可以再次调用 overlay use

(zero)> def foo [] { "foo-in-zero" }

(zero)> overlay use spam

(spam)> foo
foo

(spam)> overlay use zero

(zero)> foo
foo-in-zero

(zero)> overlay list
───┬──────
 0  spam
 1  zero
───┴──────

现在,zero 覆层具有优先权。