PowerShell对比不同文件夹文件时Out-File参数报错如何解决？

报错产生原因 #

• 核心错误是字符串拼接逻辑不符合PowerShell语法规则：原代码中$Path1 + " AND " + $Path2没有用括号包裹，PowerShell解析时会将$Path1识别为Out-File命令的额外位置参数，但Out-File没有对应接收该参数的定义，因此触发参数绑定异常。
• 次要语法错误：
  1. 多处-append参数被单独换行，PowerShell会将其识别为独立的未知命令，触发执行错误。
  2. 第二处Get-ChildItem的-filter参数和匹配规则*.dtsconfig之间缺少空格，会被识别为无效参数。
  3. 代码中使用了中文双引号，部分PowerShell版本会解析异常。
  4. 路径拼接直接用\拼接字符串，遇到路径末尾自带\的场景会出现重复斜杠错误。

修复方案 #

完整修复后代码 #

$Path1 = "D:\Path1"
$Path2 = "D:\Path2"
$OutFile = "D:\ComparisonOutputFile.txt"

If (Test-Path($OutFile)) {
    Remove-Item $OutFile
}

# 字符串拼接用括号包裹，避免参数解析错误
"Differences in files of the same name between the following folders:" | Out-File $OutFile -Append
($Path1 + " AND " + $Path2) | Out-File $OutFile -Append
"——————————————–" | Out-File $OutFile -Append

# -Filter参数后补全空格
$Dir1 = Get-ChildItem -Path $Path1 -Filter *.dtsconfig
$Dir2 = Get-ChildItem -Path $Path2 -Filter *.dtsconfig
# 仅按文件名对比，避免文件属性差异导致的匹配错误
$FileList = Compare-Object $Dir1 $Dir2 -IncludeEqual -ExcludeDifferent -Property Name

ForEach ($File in $FileList) {
    # 用Join-Path拼接路径更安全，避免斜杠重复问题
    $F1 = Join-Path $Path1 $File.Name
    $F2 = Join-Path $Path2 $File.Name
    $File.Name | Out-File $OutFile -Append
    Compare-Object (Get-Content $F1) (Get-Content $F2) | Format-Table -Auto | Out-File $OutFile -Append
}

关键修改说明 #

1. 将原本和Out-File写在同一行的路径拼接逻辑拆分，用括号包裹拼接语句后单独通过管道传给Out-File，避免参数识别混乱。
2. 所有-Append参数紧跟对应Out-File命令，不单独换行。
3. 补全-Filter参数和匹配规则之间的空格。
4. 所有中文双引号替换为英文双引号。
5. 新增Compare-Object的-Property Name参数，仅按文件名对比避免文件属性不同导致的匹配错误，同时改用Join-Path拼接路径提升兼容性。

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