使用Start-Job启动的PowerShell脚本无法立即写入日志文件怎么办？

问题根源 #

PowerShell的文件输出操作默认会使用缓冲区提升性能，加上Start-Job创建的后台作业与父进程（script1）的IO处理机制，导致script2写入的内容会暂存到内存缓冲区，直到父进程结束才统一刷入磁盘。

解决方案 #

1. 使用StreamWriter强制刷新缓冲区 #

在script2中直接调用.NET的StreamWriter类，每次写入后主动调用Flush()方法将缓冲区内容立即写入磁盘：

# 初始化StreamWriter，第二个参数$true表示追加模式
$logWriter = [System.IO.StreamWriter]::new("你的日志路径.log", $true)

# 写入日志并立即刷新
$logWriter.WriteLine("script2启动，开始执行")
$logWriter.Flush()

# 执行其他业务逻辑
# ...

# 后续写入后按需刷新
$logWriter.WriteLine("某步骤执行完成")
$logWriter.Flush()

# 最后关闭写入器
$logWriter.Close()
$logWriter.Dispose()

2. 用Out-File的-NoBuffering参数 #

如果习惯用PowerShell原生命令，可以使用Out-File并加上-NoBuffering参数，禁用输出缓冲：

"script2首行日志内容" | Out-File -Path "你的日志路径.log" -Append -NoBuffering -Encoding utf8

注意：-NoBuffering参数仅在指定-Encoding为Unicode、UTF8、UTF7、UTF32或ASCII时生效，需根据实际编码需求调整。

3. 全局禁用PowerShell输出缓冲 #

如果希望script2中所有文件写入操作都自动无缓冲，可以修改PowerShell的全局缓冲设置：

$PSDefaultParameterValues['Out-File:NoBuffering'] = $true

这种方式适合需要频繁写入日志的场景，无需每次调用都手动刷新。

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