PowerShell数组按引用传递问题：调用fallback后$compressedfiles为空

场景需求：在主路径$FilesPath下找不到.vip、.zip、.cab格式文件时，调用fallback函数从备用路径$fallbackpath查找，但调用后$compressedfiles数组始终为空，尝试引用传递和全局变量均未解决。

原始脚本代码 #

Function Init {
    $compressedfiles = @()
    $compressedfiles = Get-ChildItem -path $FilesPath\* -Include "*.vip", "*.zip", "*.cab"
    if (-Not $compressedfiles) {
        fallback
    }
}

Function fallback {
    $fallbackpath = '\\google.com\global\builds\PatchCreatorOutput'
    $compressedfiles = Get-ChildItem -path $fallbackpath\$FolderNumber\* -Include "*.vip", "*.zip", "*.cab"
    ([ref]$compressedfiles).Value = $compressedfiles
}

更新后尝试的脚本代码 #

Function Init {
        $compressedfiles = @()
        $compressedfiles = Get-ChildItem -path $FilesPath\* -Include "*.vip", "*.zip", "*.cab"
        if (-Not $compressedfiles) {
            fallback
        }


Set-Variable -Name "compressedfiles" -Value $compressedfiles -Scope global
    }
    
    Function fallback {
        $fallbackpath = '\\google.com\global\builds\PatchCreatorOutput'
        $compressedfiles = Get-ChildItem -path $fallbackpath\$FolderNumber\* -Include "*.vip", "*.zip", "*.cab"
        return $compressedfiles | out-null
    }

问题根源分析 #

1. 原始脚本问题：fallback函数内的$compressedfiles是局部变量，([ref]$compressedfiles)操作的仅为该局部变量，无法影响Init函数内的同名变量。
2. 更新后脚本问题：
   • return $compressedfiles | out-null会直接丢弃查询结果，等于未返回任何内容；
   • 即使fallback正确返回结果，Init函数也未将返回值赋值给$compressedfiles；
   • 全局变量设置时机错误，在调用fallback之后才设置，但此时$compressedfiles还是初始的空数组。

正确解决方案 #

方案1：函数返回结果，调用方接收赋值（最简单直观） #

Function Init {
    # 先从主路径查询
    $compressedfiles = Get-ChildItem -Path "$FilesPath\*" -Include "*.vip", "*.zip", "*.cab"
    # 主路径无结果时，调用fallback并接收返回值
    if (-not $compressedfiles) {
        $compressedfiles = fallback
    }
    # 如需全局变量，在此设置（确保使用最新值）
    Set-Variable -Name "compressedfiles" -Value $compressedfiles -Scope Global
}

Function fallback {
    $fallbackpath = '\\google.com\global\builds\PatchCreatorOutput'
    # PowerShell函数默认输出未捕获的结果，直接返回查询内容即可
    Get-ChildItem -Path "$fallbackpath\$FolderNumber\*" -Include "*.vip", "*.zip", "*.cab"
}

方案2：使用引用传递参数（适合需要修改外部变量的场景） #

Function Init {
    $compressedfiles = @()
    $compressedfiles = Get-ChildItem -Path "$FilesPath\*" -Include "*.vip", "*.zip", "*.cab"
    if (-not $compressedfiles) {
        # 将变量以引用方式传递给fallback
        fallback -compressedFiles ([ref]$compressedfiles)
    }
}

Function fallback {
    # 定义引用类型的参数
    param(
        [Parameter(Mandatory=$true)]
        [ref]$compressedFiles
    )
    $fallbackpath = '\\google.com\global\builds\PatchCreatorOutput'
    # 修改引用变量的Value属性，直接更新外部变量
    $compressedFiles.Value = Get-ChildItem -Path "$fallbackpath\$FolderNumber\*" -Include "*.vip", "*.zip", "*.cab"
}

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