Set-Content偶发"Stream was not readable"错误排查及优化咨询

这个问题我之前在构建脚本里踩过好几次坑，太懂那种看到文件变空、构建失败的崩溃感了！下面帮你拆解原因和对应的解决办法：

错误产生的常见原因 #

• 读写流冲突：最常见的情况是你在脚本里同时对同一个文件进行读和写操作（比如用Get-Content读文件的同时，立刻用Set-Content写回）。PowerShell的管道或命令执行顺序有时候会出现时序问题，读流还没完全关闭就打开了写流，导致流状态异常，最终写操作清空了文件但没写入内容。
• 文件被其他进程锁定：杀毒软件、代码编辑器、构建工具的其他环节可能正在占用目标文件，导致你的脚本无法正常读取文件。这时如果强行打开写流，就会把文件清空，但因为读不到原内容，最终文件变成空的。
• 编码不匹配：如果原文件使用了特殊编码（比如UTF-16带BOM、GB2312），而你用Get-Content默认的UTF-8编码读取，会导致读取时流解析错误，后续的写操作直接覆盖成空文件。
• 竞态条件：如果脚本里有异步操作或多线程处理文件，多个操作同时访问同一个文件，就会导致流状态混乱。

优化方案（按推荐程度排序） #

1. 采用「临时文件替换」的安全模式（最推荐） #

这种方法先把文件内容读到内存，写入临时文件后再替换原文件，是原子操作，就算中间出错，原文件也不会被破坏。

function Replace-FileContent {
    param(
        [Parameter(Mandatory=$true)]
        [string]$Path,
        [Parameter(Mandatory=$true)]
        [string]$OldText,
        [Parameter(Mandatory=$true)]
        [string]$NewText,
        [string]$Encoding = 'utf8'
    )

    # 一次性读取文件内容到内存
    try {
        $content = Get-Content -Path $Path -Raw -Encoding $Encoding -ErrorAction Stop
    }
    catch {
        throw "读取文件失败 [$Path] : $_"
    }

    # 执行文本替换（用[regex]::Escape避免特殊字符干扰）
    $newContent = $content -replace [regex]::Escape($OldText), $NewText

    # 写入临时文件，再替换原文件
    $tempPath = [System.IO.Path]::GetTempFileName()
    try {
        Set-Content -Path $tempPath -Value $newContent -Encoding $Encoding -ErrorAction Stop
        # Move-Item的Force参数确保覆盖，且是原子操作
        Move-Item -Path $tempPath -Destination $Path -Force -ErrorAction Stop
    }
    catch {
        # 出错时清理临时文件
        if (Test-Path $tempPath) { Remove-Item $tempPath -Force }
        throw "写入文件失败 [$Path] : $_"
    }
}

2. 使用.NET的File类方法管理流 #

PowerShell的Get-Content/Set-Content是封装后的命令，有时流管理不够严谨。直接用.NET的File.ReadAllText和File.WriteAllText，内部会自动正确打开、关闭流，避免状态异常。

function Replace-FileContent {
    param(
        [Parameter(Mandatory=$true)]
        [string]$Path,
        [Parameter(Mandatory=$true)]
        [string]$OldText,
        [Parameter(Mandatory=$true)]
        [string]$NewText,
        [System.Text.Encoding]$Encoding = [System.Text.Encoding]::UTF8
    )

    try {
        # .NET方法一次性读写，自动处理流的生命周期
        $content = [System.IO.File]::ReadAllText($Path, $Encoding)
        $newContent = $content -replace [regex]::Escape($OldText), $NewText
        [System.IO.File]::WriteAllText($Path, $newContent, $Encoding)
    }
    catch {
        throw "处理文件失败 [$Path] : $_"
    }
}

3. 提前检测文件锁定状态 #

在操作文件前，先检查文件是否被其他进程占用，避免强行操作导致文件损坏：

# 辅助函数：检测文件是否被锁定
function Test-FileLock {
    param([string]$Path)
    try {
        # 尝试以独占方式打开文件，失败则说明被锁定
        $fileStream = [System.IO.File]::Open(
            $Path,
            [System.IO.FileMode]::Open,
            [System.IO.FileAccess]::ReadWrite,
            [System.IO.FileShare]::None
        )
        $fileStream.Close()
        $fileStream.Dispose()
        return $false
    }
    catch {
        return $true
    }
}

# 在替换函数中加入检测
function Replace-FileContent {
    param(...)
    
    if (Test-FileLock -Path $Path) {
        throw "文件 [$Path] 被其他进程锁定，请关闭占用该文件的程序后重试"
    }

    # 后续读写操作...
}

4. 明确指定文件编码 #

如果原文件使用非默认编码，一定要在读取和写入时明确指定，比如：

# 读取UTF-16（Unicode）编码的文件
$content = Get-Content -Path $Path -Raw -Encoding Unicode
# 写入时也要用相同编码
Set-Content -Path $Path -Value $newContent -Encoding Unicode

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