PowerShell函数返回值重复问题：为何调用时得到重复路径？

核心原因分析 #

你的Get-DateFolder函数大概率返回了多值输出，而非单一字符串路径。PowerShell函数默认会收集所有未被抑制的命令输出作为返回内容，哪怕你写了return语句。

比如函数内执行New-Item -Path $targetPath -ItemType Directory -Force时，这个命令会返回创建的文件夹对象；如果没有抑制这个输出，再加上你手动return的路径字符串，函数就会返回一个包含两个元素的数组：文件夹对象和路径字符串。回到循环后，$TargetFolder就变成了数组，后续Count-Existing里的Get-ChildItem会尝试解析数组中的非字符串元素，导致路径不存在报错。

验证方法 #

在循环内添加以下代码，确认$TargetFolder的类型和内容：

$TargetFolder = Get-DateFolder -File $file
# 打印类型和所有元素
Write-Host "类型: $($TargetFolder.GetType().Name)"
Write-Host "所有内容: $($TargetFolder | ForEach-Object { $_ })"

如果输出显示类型为Object[]且包含两个元素，就坐实了多值返回的问题。

解决方案 #

1. 抑制New-Item的输出 #

修改Get-DateFolder函数，在创建文件夹的命令后添加| Out-Null，阻止文件夹对象被混入返回值：

function Get-DateFolder {
    param(
        [string]$File
    )
    # 你的日期路径生成逻辑...
    $targetPath = Join-Path -Path $baseDir -ChildPath $dateDir
    # 抑制New-Item的输出，只保留手动返回的路径
    New-Item -Path $targetPath -ItemType Directory -Force | Out-Null
    return $targetPath
}

2. 清理函数内所有未捕获的输出 #

检查函数内所有代码，确保除了return语句外，没有其他未被捕获的输出。比如如果有单独的变量打印（如$targetPath没有赋值或return），这类语句的输出也会被混入返回值，必须删除或用Out-Null处理。

3. 确保返回值为纯字符串 #

如果需要更严谨，可以强制将返回值转为字符串类型：

return [string]$targetPath

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