命令行与文本处理 / 系统课时
调试 PowerShell 脚本
调试 PowerShell 脚本
本课用一个可复现的计算错误演示完整调试闭环:先设置断点,再检查变量与调用栈,随后逐步执行并验证修复结果。完成后,你既能在终端中定位问题,也能在 VS Code 中使用同一套思路调试函数、分支和循环。
学习目标
- 区分行断点、命令断点和变量断点的适用场景
- 在暂停位置检查局部变量、当前语句和调用栈
- 使用终端或 VS Code 完成“复现、定位、修复、验证”闭环
先选择正确的暂停位置
PowerShell 调试器支持行、命令和变量断点,并提供 Get-PSBreakpoint、Remove-PSBreakpoint 与 Get-PSCallStack 等命令。先在异常结果出现前暂停,比在脚本末尾反复打印变量更容易确定是哪一步首次偏离预期。:contentReference[oaicite:0]{index=0}
- 分支判断错误:把行断点放在
if或switch条件之前。 - 循环结果异常:在循环体首行暂停,观察计数器和当前元素。
- 函数返回错误:在函数入口、返回表达式或关键命令处暂停。
- 变量被意外覆盖:使用变量断点跟踪写入行为。

在终端中复现与检查
下面的示例在 Write-Output 执行前触发命令断点。断点动作读取函数中的局部变量,打印调用栈后自动继续,因此可以直接运行,不需要手工输入调试命令。
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预期输出
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}
编辑器只是把终端调试能力可视化。遇到断点不命中时,先确认正在运行的是当前保存的文件,再检查断点是否落在可执行语句上;空行、注释或尚未调用的函数定义不会按预期暂停。