右键运行PowerShell脚本时函数调用抛出异常的问题排查

我编写的PowerShell脚本在PowerShell ISE中运行、粘贴到PowerShell窗口执行均正常，但右键点击脚本选择「用PowerShell运行」时，调用GUITitleTextBox_TextChanged函数会抛出异常。

相关代码 #

函数定义 #

function GUITitleTextBox_TextChanged
{
    [CmdletBinding()]
    param
    (
        [parameter(Mandatory=$True, Position=0)][System.Object]    $Sender,
        [parameter(Mandatory=$True, Position=1)][System.EventArgs] $EventArguments,
        [parameter(Mandatory=$True, Position=2)][String]           $Text,
        [parameter(Mandatory=$False, Position=3)][System.Object]   $Control1ToUpdate,
        [parameter(Mandatory=$False, Position=4)][System.Object]   $Control2ToUpdate
    )
    
    $Control1ToUpdate.Text = $Text
    $Control2ToUpdate.Text = $Text
}

函数调用代码 #

$GUITitleTextBox_Handler = {GUITitleTextBox_TextChanged -Sender $GUITitleTextBox -EventArguments $_ -Text $GUITitleTextBox.Text -Control1ToUpdate $DefaultFormTab -Control2ToUpdate $FormLabel}.GetNewClosure()

$GUITitleTextBox.Add_TextChanged($GUITitleTextBox_Handler)

异常信息（仅右键运行时出现） #

GUITitleTextBox_TextChanged : The term 'GUITitleTextBox_TextChanged' is not recognized as the name of a cmdlet,
function, script file, or operable program. Check the spelling of the name, or if a path was included, verify that the
path is correct and try again.
At <Path>\PowerShell-GUI.ps1:899 char:33
+     $GUITitleTextBox_Handler = {GUITitleTextBox_TextChanged -Sender $ ...
+                                 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : ObjectNotFound: (GUITitleTextBox_TextChanged:String) [], CommandNotFoundException
    + FullyQualifiedErrorId : CommandNotFoundException

异常成因 #

核心是脚本执行的作用域差异：

• 在ISE或直接粘贴执行时，函数和脚本变量都处于当前会话的顶层作用域，事件处理脚本块执行时能正常找到已定义的函数。
• 右键「用PowerShell运行」时，脚本会启动一个新的PowerShell子进程，脚本在该进程的局部作用域中执行。GetNewClosure()只会捕获当前作用域的变量，不会捕获函数定义；当脚本执行完毕退出局部作用域后，函数会被销毁，事件触发时脚本块无法找到该函数，从而抛出异常。

解决方法 #

方案1：将函数逻辑直接嵌入事件处理脚本块 #

去掉独立的函数定义，把逻辑直接写到事件处理脚本块中，确保闭包包含所有必要逻辑：

$GUITitleTextBox_Handler = {
    $DefaultFormTab.Text = $GUITitleTextBox.Text
    $FormLabel.Text = $GUITitleTextBox.Text
}.GetNewClosure()

$GUITitleTextBox.Add_TextChanged($GUITitleTextBox_Handler)

方案2：将函数定义为全局作用域函数 #

在函数名前添加global:前缀，让函数在全局作用域生效，即使脚本局部作用域退出，事件触发时仍能找到函数：

function global:GUITitleTextBox_TextChanged
{
    [CmdletBinding()]
    param
    (
        [parameter(Mandatory=$True, Position=0)][System.Object]    $Sender,
        [parameter(Mandatory=$True, Position=1)][System.EventArgs] $EventArguments,
        [parameter(Mandatory=$True, Position=2)][String]           $Text,
        [parameter(Mandatory=$False, Position=3)][System.Object]   $Control1ToUpdate,
        [parameter(Mandatory=$False, Position=4)][System.Object]   $Control2ToUpdate
    )
    
    $Control1ToUpdate.Text = $Text
    $Control2ToUpdate.Text = $Text
}

方案3：将函数转为脚本块变量并通过闭包捕获 #

把函数定义成脚本块类型的变量，这样GetNewClosure()会将其作为变量捕获，事件触发时可正常调用：

# 将函数定义为脚本块变量
$GUITitleTextBox_TextChanged = {
    param
    (
        [parameter(Mandatory=$True, Position=0)][System.Object]    $Sender,
        [parameter(Mandatory=$True, Position=1)][System.EventArgs] $EventArguments,
        [parameter(Mandatory=$True, Position=2)][String]           $Text,
        [parameter(Mandatory=$False, Position=3)][System.Object]   $Control1ToUpdate,
        [parameter(Mandatory=$False, Position=4)][System.Object]   $Control2ToUpdate
    )
    
    $Control1ToUpdate.Text = $Text
    $Control2ToUpdate.Text = $Text
}

# 事件处理脚本块中调用该脚本块变量
$GUITitleTextBox_Handler = {
    & $GUITitleTextBox_TextChanged -Sender $GUITitleTextBox -EventArguments $_ -Text $GUITitleTextBox.Text -Control1ToUpdate $DefaultFormTab -Control2ToUpdate $FormLabel
}.GetNewClosure()

$GUITitleTextBox.Add_TextChanged($GUITitleTextBox_Handler)

内容的提问来源于stack exchange，提问作者Mikepedia