PowerShell Start-ThreadJobs日志输出对齐异常问题求助

这种日志错位的核心原因通常是换行符不统一（比如混用回车\r和换行\n）、线程写入时未正确处理换行，或是读取时未清理多余的空白/控制字符。以下是具体解决步骤：

1. 统一线程日志写入的换行符 #

线程任务中写入日志时，明确使用PowerShell标准换行符，避免跨系统或不规范的换行问题：

• 用Add-Content（默认自动添加正确换行）：

  $logPath = ".\logs\qemu1.log"
  Add-Content -Path $logPath -Value "Test Run Start Time $(Get-Date -Format 'o')" -Encoding UTF8
  

• 或手动指定换行符写入：

  $logEntry = "##vso[task.logissue type=error] Simulated failure for FakeTest1" + [Environment]::NewLine
  $logEntry | Out-File -Path $logPath -Append -Encoding UTF8 -NoNewline
  

2. 读取日志时清理异常字符和空白 #

读取日志文件后，先统一换行格式，再清理每行前后的多余空白，避免光标错位：

$logPath = ".\logs\qemu1.log"
# 读取整个日志内容
$rawContent = Get-Content -Path $logPath -Raw -Encoding UTF8
# 替换所有非标准换行（单独的\r或\r\n）为PowerShell标准换行`n
$cleanedContent = $rawContent -replace '\r(?!\n)', '' -replace '\r?\n', "`n"
# 拆分每行并清理前后空白后输出
$cleanedContent -split "`n" | ForEach-Object { $_.Trim() } | Write-Host

注：单独的\r（回车符）会让光标回到当前行开头，是导致后续内容覆盖前面的关键原因，必须替换掉。

3. 并发写入时加锁（多线程共享日志文件时） #

如果多个线程需要写入同一个日志文件，必须添加锁机制避免内容交织：

# 定义全局锁对象
$logLock = New-Object System.Object

# 线程内写入逻辑
lock ($logLock) {
    [System.IO.File]::AppendAllText(
        $logPath,
        "QEMU Instance: qemu1`n",
        [System.Text.Encoding]::UTF8
    )
}

验证效果 #

处理后的日志输出会恢复正常格式，示例如下：

>>> Finished running tests
Test Run Start Time 2025-05-27T04:58:01.821Z
QEMU Instance: qemu1
##vso[task.logissue type=error] Simulated failure for FakeTest1
##vso[task.logissue type=error] Test Name: FakeTest1
##vso[task.logissue type=error] Error Code: 1
##vso[task.logissue type=error] Command: fake command 1

QEMU Instance: qemu1
##vso[task.logissue type=error] Simulated failure for FakeTest2
##vso[task.logissue type=error] Test Name: FakeTest2

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