PowerShell脚本处理含通配符类特殊字符的文件路径及外部程序调用问题

你拼接生成路径字符串的写法本身没有问题，报错根源不在字符串构造环节：PowerShell 在使用路径执行操作（读写文件、给外部程序传参等）时，默认会把传入的路径当做通配符规则解析，而非纯字面量处理。你不需要在构造字符串时做额外的“字面量转义”，只要在使用路径的环节避开通配符解析逻辑即可。

优先用 PowerShell 原生的 Join-Path 拼接路径，比手动拼斜杠更安全，不会出现路径分隔符错误，生成的字符串本身就是合法的绝对路径，不需要额外处理特殊字符：

$logfile = Join-Path -Path $output_folder -ChildPath "myscript.log"
$inputFilePath = Join-Path -Path $output_folder -ChildPath $inputFile
$xslFilePath = Join-Path -Path $output_folder -ChildPath $transformation_filename
$outputFilePath = Join-Path -Path $output_folder -ChildPath $outputFile

1. 原生 PowerShell cmdlet 场景 #

比如 Out-File 这类支持通配符参数的 cmdlet，只要把路径传给 -LiteralPath 参数，就会完全跳过通配符解析，把路径当做纯字面量处理：

(Get-Date -Format "[yyyy-MM-dd HH:mm:ss]") | Out-File -LiteralPath $logfile -Append

2. 调用外部可执行程序的传参场景 #

你调用的 Saxonica Transform.exe 是原生 Windows 程序，本身完全不识别 PowerShell 的通配符规则，路径中的 [] 对它来说就是普通的文件名字符。之前的报错不是程序本身的问题，是 PowerShell 在拼接命令行参数时，提前把路径里的 [] 当通配符解析，导致传给 exe 的参数路径错误。

• 解决方法：用 PowerShell 的调用运算符 & + 显式参数数组传参，不要把路径硬拼在命令行字符串里，PowerShell 会自动处理带特殊字符的参数，不会做通配符解析：

$transformExe = "C:\Program Files\Saxonica\SaxonHE9.8N\bin\Transform.exe"
# 把所有参数单独放到数组里，避免PowerShell提前解析特殊字符
$transformArgs = @(
  "-s:$inputFilePath",
  "-xsl:$xslFilePath",
  "-o:$outputFilePath",
  "-t"
)
# 执行外部程序
& $transformExe $transformArgs

3. 日志重定向场景 #

PowerShell 的重定向运算符（>>、2>&1、1>>）和原生 cmdlet 逻辑一致，默认会对后面的路径做通配符解析，如果日志路径含特殊字符，直接用 1>> $logfile 还是会触发报错。可以用两种方案绕开：

• 方案1：先捕获外部程序的所有输出，再用支持 -LiteralPath 的 cmdlet 写入日志

# 捕获外部程序的标准输出、错误输出到变量
$transformResult = & $transformExe $transformArgs 2>&1
# 追加写入日志，完全避免通配符解析
$transformResult | Out-File -LiteralPath $logfile -Append

• 方案2：直接用 .NET 原生的文件写入方法，完全绕开 PowerShell 的路径解析逻辑：

# 以追加模式打开日志文件流
$logWriter = [System.IO.StreamWriter]::new($logfile, $true)
try {
  # 把所有输出逐行写入日志
  & $transformExe $transformArgs *>&1 | ForEach-Object { $logWriter.WriteLine($_) }
} finally {
  # 确保文件流释放
  $logWriter.Close()
  $logWriter.Dispose()
}

• 用单引号包裹变量的写法 $logfile='$output_folder' + "\myscript.log" 无法生效：PowerShell 中单引号包裹的字符串是纯字面量，不会解析变量值，最终会生成包含字面量 $output_folder 的错误路径。
• 把参数类型定义为 [IO.DirectoryInfo] 无法解决问题：该类型只是把输入字符串转换为目录信息对象，PowerShell 在后续使用路径、传参时还是会默认执行通配符解析逻辑，不会自动按字面量处理。

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