PowerShell中@()构造写法差异致补全失效？是否为Bug？

我需要为foo函数的name参数实现Tab补全，补全值需包含指定路径下的文件名，同时添加自定义补全值。函数代码如下：

Function foo{
    Param(
    [ValidateSet([layoutNames], ErrorMessage = """{0}"" Is not a valid Layout name")]
    $Name
    )
    $name
}

对应的layoutNames验证类中，仅第三种return写法能正常触发所有补全（文件名+自定义值），前两种写法仅提示自定义值：

Class layoutNames : System.Management.Automation.IValidateSetValuesGenerator{
    [string[]] GetValidValues(){
        # 无效：仅提示valueFoo、valueBar
        #return @((Get-ChildItem -path 'c:\temp' -File).BaseName, "valueFoo", "valueBar")
        # 无效：仅提示valueFoo、valueBar
        #return @("valueFoo", "valueBar", (Get-ChildItem -path 'c:\temp' -File).BaseName)
        # 有效：提示valueFoo、valueBar及文件名
        return @(                
                    "valueFoo", "valueBar"
                    (Get-ChildItem -path 'c:\temp' -File).BaseName
                )
    }}

我最初尝试用return [string[]]("valueFoo", "valueBar", (Get-ChildItem ...).BaseName)也无效，核心问题：为什么以下写法无法让foo同时提示所有补全值？

Class layoutNames : System.Management.Automation.IValidateSetValuesGenerator{
    [string[]] GetValidValues(){
        # 无效：仅提示valueFoo、valueBar
        #return [string[]]("valueFoo", "valueBar",(Get-ChildItem -path 'C:\Users\INDESK\AppData\Roaming\GPSoftware\Directory Opus\Layouts' -File).BaseName)
        # 无效：仅提示valueFoo、valueBar
        #return [string[]]("valueFoo", "valueBar",((Get-ChildItem -path 'C:\Users\INDESK\AppData\Roaming\GPSoftware\Directory Opus\Layouts' -File).BaseName))
        # 无效：仅提示valueFoo、valueBar
        #return [string[]](((Get-ChildItem -path 'C:\Users\INDESK\AppData\Roaming\GPSoftware\Directory Opus\Layouts' -File).BaseName),"valueFoo", "valueBar")
    }}

环境：PowerShell 7.4 / Windows 11

问题出在PowerShell的数组构造逻辑：

1. 逗号分隔的数组列表不会自动展开嵌套数组：当你用("a", "b", $array)这种写法时，$array本身作为单个元素被加入外层数组，而非将$array的元素逐一展开。比如(Get-ChildItem ...).BaseName返回的是字符串数组，在逗号列表里它会被当作一个数组元素，而非多个字符串元素。
2. 强制转换[string[]]的局限性：当你把包含嵌套数组的集合强制转为[string[]]时，嵌套数组会被转换成其类型字符串（如System.String[]），而非展开元素，PowerShell的补全机制无法识别这类无效值，因此只显示前两个合法字符串。
3. 换行的@()写法为何有效：在@()数组子表达式中，换行分隔的多个表达式会被逐一执行，每个表达式的结果（包括数组）会自动展开并合并为一维数组。比如@( "a", "b"; $array )或换行写法，会把$array的所有元素都加入最终数组。

可以通过以下几种方式正确合并数组元素：

方法1：用+运算符合并数组 #

通过+直接拼接多个数组/字符串，PowerShell会自动展开并合并为一维数组：

Class layoutNames : System.Management.Automation.IValidateSetValuesGenerator{
    [string[]] GetValidValues(){
        $fileNames = (Get-ChildItem -path 'C:\Users\INDESK\AppData\Roaming\GPSoftware\Directory Opus\Layouts' -File).BaseName
        return $fileNames + "valueFoo" + "valueBar"
    }
}

方法2：用@()展开嵌套数组 #

在逗号列表中，用@()显式展开子数组，避免嵌套：

Class layoutNames : System.Management.Automation.IValidateSetValuesGenerator{
    [string[]] GetValidValues(){
        return @( 
            "valueFoo", 
            "valueBar", 
            @(Get-ChildItem -path 'C:\Users\INDESK\AppData\Roaming\GPSoftware\Directory Opus\Layouts' -File).BaseName 
        )
    }
}

方法3：保持换行的@()写法（原有效写法） #

利用@()子表达式的换行自动展开特性，这种写法直观且有效：

Class layoutNames : System.Management.Automation.IValidateSetValuesGenerator{
    [string[]] GetValidValues(){
        return @(                
            "valueFoo", "valueBar"
            (Get-ChildItem -path 'C:\Users\INDESK\AppData\Roaming\GPSoftware\Directory Opus\Layouts' -File).BaseName
        )
    }
}

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