命令行与文本处理 / 系统课时

调试 PowerShell 脚本

调试 PowerShell 脚本

本课用一个可复现的计算错误演示完整调试闭环:先设置断点,再检查变量与调用栈,随后逐步执行并验证修复结果。完成后,你既能在终端中定位问题,也能在 VS Code 中使用同一套思路调试函数、分支和循环。

学习目标

  • 区分行断点、命令断点和变量断点的适用场景
  • 在暂停位置检查局部变量、当前语句和调用栈
  • 使用终端或 VS Code 完成“复现、定位、修复、验证”闭环

先选择正确的暂停位置

PowerShell 调试器支持行、命令和变量断点,并提供 Get-PSBreakpoint、Remove-PSBreakpoint 与 Get-PSCallStack 等命令。先在异常结果出现前暂停,比在脚本末尾反复打印变量更容易确定是哪一步首次偏离预期。:contentReference[oaicite:0]{index=0}

  • 分支判断错误:把行断点放在 if 或 switch 条件之前。
  • 循环结果异常:在循环体首行暂停,观察计数器和当前元素。
  • 函数返回错误:在函数入口、返回表达式或关键命令处暂停。
  • 变量被意外覆盖:使用变量断点跟踪写入行为。

PowerShell 调试闭环流程图

在终端中复现与检查

下面的示例在 Write-Output 执行前触发命令断点。断点动作读取函数中的局部变量,打印调用栈后自动继续,因此可以直接运行,不需要手工输入调试命令。

powershell
function Get-DiscountPrice {
    param(
        [Parameter(Mandatory)]
        [decimal]$Amount
    )

    $rate = if ($Amount -ge 100) { 0.2 } else { 0.1 }
    $result = $Amount * (1 - $rate)
    Write-Output ([int]$result)
}

$breakpoint = Set-PSBreakpoint -Command Write-Output -Action {
    $amountValue = Get-Variable -Name Amount -ValueOnly
    $rateValue = Get-Variable -Name rate -ValueOnly

    Write-Host "BREAK amount=$amountValue rate=$rateValue"
    Get-PSCallStack |
        Select-Object -First 2 Command, Location |
        Format-Table -AutoSize |
        Out-String |
        Write-Host

    continue
}

Get-DiscountPrice -Amount 150
Remove-PSBreakpoint -Breakpoint $breakpoint

预期输出

text
BREAK amount=150 rate=0.2

Command             Location
-------             --------
Get-DiscountPrice   <PATH>: line <ID>
<ScriptBlock>       <PATH>: line <ID>

120

<PATH> 与 <ID> 会随保存位置和代码行号变化。关键验证点是断点中能读取 Amount=150、rate=0.2,调用栈能显示当前函数及其调用者,最终结果为 120。

暂停后如何逐步定位

当普通断点没有配置 -Action 时,命中后会进入调试提示符。此时不要立即修改代码,先确认“输入是否正确、分支是否正确、变量何时变化、调用来自哪里”。

命令 作用 适合检查
l 列出当前位置附近源码 当前暂停语句
s 单步进入 函数或脚本块内部
v 单步越过 不需要展开的函数调用
o 跳出当前函数 返回调用者
k 查看调用栈 调用路径与嵌套层级
c 继续运行 到下一个断点
t 停止调试 终止本次执行

在调试提示符中可以直接输入 $Amount、$rate 或 Get-PSCallStack。调用栈显示“当前函数由谁调用”,特别适合排查同一函数被多个入口以不同参数调用的情况。:contentReference[oaicite:1]{index=1}

在 VS Code 中调试

安装 Microsoft PowerShell 扩展后,打开 .ps1 文件,在目标行左侧单击或按 F9 设置断点,再按 F5 启动调试。暂停后可在运行和调试视图查看 Variables、Watch、Call Stack 与 Breakpoints,并用悬停或调试控制台检查表达式。:contentReference[oaicite:2]{index=2}

编辑器只是把终端调试能力可视化。遇到断点不命中时,先确认正在运行的是当前保存的文件,再检查断点是否落在可执行语句上;空行、注释或尚未调用的函数定义不会按预期暂停。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

调试 PowerShell 脚本

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通