powershell - 'local' 是 PowerShell 模块中的函数参数

Question

我在 PowerShell 中发现了一个令我吃惊的行为，我正在寻找解释。请考虑以下名为 testParameter 的 PowerShell 模块:

testParameter.psd1:

@{
   RootModule         = 'testParameter.psm1'
   ModuleVersion      = '0.1'

   FunctionsToExport  = @(
      'get-embeddedString'
   )
}

testParameter.psm1:

set-strictMode -version 3

function embed-string {

   param (
      [string] $pre,
      [string] $post
   )

  "$($pre)$text$($post)"
}


function get-embeddedString {

   param (
      [string] $text
   )

   return embed-string '>>> ' ' <<<'
}

当我调用 get-embeddedString foo 时，该函数返回(或控制台打印):

>>> foo <<<

我很惊讶，因为这个字符串是在函数 embed-string 中呈现的，它没有声明名为 $text 的局部变量，也没有具有该名称的参数并且在使用它之前没有为其赋值，我预计该函数会抛出一个The variable '$text' cannot be retrieved because it has not been set. 错误。

显然，embed-string 选择使用 $text 在 get-embeddedString 中的值，我认为这是一个不同的和不相关的范围。

我不明白这里发生了什么，也不知道在哪里可以找到与此行为相关的文档。

Answer 1

about_Scopes是描述 PowerShell 中的范围 的官方概念性帮助主题(通常但不限于与变量 相关)，但让我提供一个简明的解释:

• 与大多数 shell 一样，PowerShell 使用动态而不是词法作用域。

  • 也就是说，变量的可见性取决于运行时调用堆栈，而不是仅对封闭的词法结构可见，例如函数定义。换句话说:给定函数或脚本看到的变量取决于调用它的人。
  • 除非调用者使用 $private: 范围显式隐藏变量，否则所有后代范围默认都能看到它们.

• 因此，因为您的 embed-string 函数是从您的 get-embeddedString 函数调用的，而后者定义了一个 $text变量(在这种情况下通过 parameter 声明)，$text 变量对于 embed-string 也是可见的 - 并且对于从它调用的函数(等等)。

值得注意的陷阱:

• 虽然对祖先变量的非限定(非作用域)读取访问获取其值，赋值隐式创建一个新的，local shadows 祖先变量。

  • 例如，"$($pre)$text$($post)" 在您的 embed-string 函数中 获取 的值祖先的 $text 变量，但是如果你要在那里执行，比如说，$text = 'value'，你会创建一个 本地变量name，然后对调用堆栈上的任何 embed-strings 后代可见，但与原始 get-embeddedstring $text 变量。

• 只有在相同作用域域(又名 session 状态)、相同运行空间中的作用域才会表现出这种关系； 每个模块都有自己的范围域，所有非模块代码共享一个单独的域。所有范围域共享的唯一一个范围是全局范围，它是所有范围域的根范围。

参见 this answer 的底部部分获取 PowerShell 作用域的综合概述。