PowerShell嵌套脚本块日志缩进包装函数异常及优化咨询

我正在编写一个用于日志文件缩进的简单函数，原理很基础：Set-LogIndent会为后续所有日志命令增加缩进，Set-LogOutdent会为后续所有日志命令减少缩进。

原本的实现方式：

Log-Message "Before we indent"
Set-LogIndent
Log-Message "Hello World" 
Set-LogOutdent
Log-Message "After we indent"

日志/控制台输出：

Before we indent
 - Hello World
After we indent

但这种方式存在两个问题：

• 代码块可能很大，难以追踪缩进/取消缩进命令的位置；
• 嵌套使用时，无法区分哪个Set-LogOutdent对应哪个Set-LogIndent。

因此我创建了一个类似Using语句的包装函数：

function Use-LogIndent {
    param (
        $ScriptBlock
    )

    Set-LogIndent
    & $ScriptBlock
    Set-LogOutdent
}

使用方式：

Use-LogIndent {
   Log-Message "Hello World" 
}

这种方式在非嵌套时效果很好，但嵌套使用时：

Use-LogIndent {
  Log-Message "Hello World"

  Use-LogIndent {
     Log-Message "Saying Hello World again!"
  }
}

整个脚本块要么被输出为文本，要么$ScriptBlock参数为$null。请问我是否未遵循正确模式？有没有更简便的实现方式？

问题原因与解决方法 #

你的核心问题是参数定义未明确指定类型，PowerShell在嵌套传递脚本块时无法正确识别。只需给$ScriptBlock参数指定[scriptblock]类型，再配合try/finally保证缩进恢复，就能解决问题：

function Use-LogIndent {
    param (
        [Parameter(Mandatory)]
        [scriptblock]$ScriptBlock
    )

    try {
        Set-LogIndent
        & $ScriptBlock
    }
    finally {
        Set-LogOutdent
    }
}

关键改进点： #

• 显式指定[scriptblock]类型，确保PowerShell正确解析传入的脚本块，包括嵌套场景；
• 添加try/finally块，即使脚本块执行抛出异常，也能保证缩进被正确恢复，避免后续日志格式混乱；
• 加上[Parameter(Mandatory)]，强制要求传入脚本块，避免参数缺失导致的$null问题。

修改后运行嵌套代码，就能得到正确的嵌套缩进输出：

Hello World
 - Saying Hello World again!

更简便的封装实现（可选） #

如果不想单独维护Set-LogIndent/Set-LogOutdent，可以直接在Use-LogIndent里维护脚本级别的缩进计数器，把逻辑封装得更紧凑：

# 脚本级变量存储缩进层级，初始为0
$script:logIndentLevel = 0

function Log-Message {
    param([string]$Message)
    # 根据层级生成缩进符号
    $indent = ' -' * $script:logIndentLevel
    Write-Host "$indent $Message".TrimStart()
}

function Use-LogIndent {
    param(
        [Parameter(Mandatory)]
        [scriptblock]$ScriptBlock
    )

    try {
        $script:logIndentLevel++
        & $ScriptBlock
    }
    finally {
        $script:logIndentLevel--
    }
}

这种方式不需要额外的Set-*命令，直接通过Use-LogIndent控制缩进层级，嵌套使用完全正常，逻辑也更简洁。

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