覆层

覆层(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

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

(zero)> overlay use spam

(spam)> module scratchpad { }

(spam)> overlay use scratchpad

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

(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 覆层具有优先权。