如何在PowerShell函数中使用Add-Member添加带源码行号的成员

嘿，我完全懂你想要实现的效果——给PowerShell函数对象加个带源代码行号的成员，这样后续在脚本里能快速定位到函数的位置对吧？我之前折腾过类似的需求，给你分享两个实用的实现方法：

这种方式会在你访问属性的时候实时计算行号，好处是如果函数后续被修改，行号会自动更新，非常灵活：

# 先定义一个示例函数
function Test-MyFunction {
    Write-Host "Hello from the test function!"
}

# 给函数添加名为SourceLineNumber的动态属性
Test-MyFunction | Add-Member -MemberType ScriptProperty -Name SourceLineNumber -Value {
    # 通过AST（抽象语法树）获取函数定义的起始行号
    $this.ScriptBlock.Ast.Extent.StartLineNumber
} -Force

# 测试访问这个属性
Test-MyFunction.SourceLineNumber

运行后你就能直接通过函数名.SourceLineNumber拿到它的定义行号啦。如果函数是从脚本文件里加载的，这个方法也能正确获取到文件中的行号，不止局限于交互式会话里的函数。

如果你的函数不会频繁修改，想要一次性把行号存成静态属性（访问速度更快），可以用下面的脚本：

# 定义一个批量处理的函数
function Add-SourceLineNumberToFunction {
    param(
        [Parameter(Mandatory, ValueFromPipeline)]
        [System.Management.Automation.FunctionInfo]$Function
    )

    process {
        # 获取函数的起始行号
        $lineNum = $Function.ScriptBlock.Ast.Extent.StartLineNumber
        # 添加静态NoteProperty成员
        $Function | Add-Member -MemberType NoteProperty -Name SourceLineNumber -Value $lineNum -Force
        return $Function
    }
}

# 给单个函数添加行号属性
Get-Command Test-MyFunction | Add-SourceLineNumberToFunction

# 或者给当前会话所有函数批量添加
Get-Command -CommandType Function | Add-SourceLineNumberToFunction

# 查看结果
Test-MyFunction.SourceLineNumber

这个方法会把行号一次性写入函数对象，后续访问不需要重新计算，但如果函数代码被修改了，需要重新运行这个命令来更新行号。

如果你想要同时拿到函数所在的文件路径和行号，可以扩展成一个复合属性：

Test-MyFunction | Add-Member -MemberType ScriptProperty -Name SourceLocation -Value {
    $extent = $this.ScriptBlock.Ast.Extent
    [PSCustomObject]@{
        FilePath = $extent.File
        StartLine = $extent.StartLineNumber
        EndLine = $extent.EndLineNumber
    }
} -Force

# 访问完整定位信息
Test-MyFunction.SourceLocation

这样就能直接得到函数的完整源代码位置，定位起来更方便！

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