PowerShell脚本备份后无法追加内容问题排查

1. 核心问题：路径拼接语法错误 #

你的备份代码里的路径拼接写法$someFile".bak"不符合PowerShell语法规范，会导致Test-Path和Copy-Item的路径解析异常：

• 错误写法：$someFile".bak"
• 正确写法：采用双引号插值或字符串拼接：

  # 方式1：双引号插值
  if (-NOT (Test-Path -Path "$someFile.bak"))
  {
     Copy-Item -Path $someFile -Destination "$someFile.bak"
  }
  # 方式2：字符串拼接
  if (-NOT (Test-Path -Path ($someFile + ".bak")))
  {
     Copy-Item -Path $someFile -Destination ($someFile + ".bak")
  }
  

错误的路径拼接会导致备份操作出错，要么备份文件被创建在错误位置，要么Copy-Item执行时产生未捕获的异常，进而干扰后续Set-Content的执行。

2. Switch匹配失效的修复 #

你的switch -Wildcard中#*仅能匹配无任何前导空格、以#开头的行，若原文件的注释行带有缩进（比如你代码里的 #Back the file），则无法被匹配，直接触发default { break }，导致收集到的原有内容为空，最终Set-Content仅写入新增字符串，看起来像是无效果。

要匹配带前导空格的注释行，需修改通配符为[ ]*#*（匹配0个或多个空格后紧跟#的行）：

switch -Wildcard -File $someFile{
  '[ ]*#*' { $_ } # 匹配带前导空格的注释行
  default { break }
}

3. 优化文件读写逻辑 #

为避免潜在的文件锁定问题，可先将文件内容读取到变量中再处理，而非直接通过switch -File读取后立即写入：

if (-NOT ($json.CaptureSettings.IncludeProcess))
{   
   # 先读取文件内容到变量
   $fileContent = @(
     switch -Wildcard (Get-Content $someFile) {
       '[ ]*#*' { $_ }
       default { break }
     }
   )
   # 拼接新增内容并写入
   $newContent = $fileContent + "`n`n# Dummy process inserted here", "`n EMPTY_PROCESS.EXE"
   Set-Content $someFile -Value $newContent
}

完整修复后的代码 #

# 备份文件（修复路径拼接）
if (-NOT (Test-Path -Path "$someFile.bak"))
{
   Copy-Item -Path $someFile -Destination "$someFile.bak"
}
  
if (-NOT ($json.CaptureSettings.IncludeProcess))
{   
   $fileContent = @(
     switch -Wildcard (Get-Content $someFile) {
       '[ ]*#*' { $_ } # 匹配带前导空格的注释行
       default { break }
     }
   )
   $newContent = $fileContent + "`n`n# Dummy process inserted here", "`n EMPTY_PROCESS.EXE"
   Set-Content $someFile -Value $newContent
}

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