使用断点与单步

进入调试状态后，WasomeCodeX_AI 会显示调试工具条，并在右侧打开调试面板。用户可以在程序中设置断点，让 PLC 程序运行到指定位置时暂停，再结合单步执行、变量查看和调用栈分析程序逻辑。

提示

启动调试器的操作请参考启动调试。

进入调试模式

成功启动调试后，编辑区上方会显示调试工具条。工具条用于控制程序继续运行、单步执行、跳出当前调用或停止调试。

常用按钮说明如下：

按钮	说明
继续	从当前位置继续运行，直到遇到下一个断点或程序继续循环执行。
单步	按当前调试上下文逐步执行程序语句。
跳出	从当前调用层级返回上一级调用位置。
重启	重新启动当前调试会话。
停止	结束调试会话并退出调试状态。

设置断点

打开需要调试的程序，在代码编辑器左侧行号区域单击即可设置断点。断点设置成功后，行号旁会显示断点标记。

图中在程序左侧设置了断点。PLC 程序运行到断点所在语句时会暂停，当前执行行会高亮显示。

备注

PLC APP 通常按照任务周期循环执行。设置断点后，程序可能会在下一个扫描周期运行到该位置时暂停。

查看变量和调用栈

程序停在断点处后，可以在右侧调试面板中查看当前上下文信息。

区域	说明
调用堆栈	显示当前程序停在的 POU、文件位置和调用关系。
Locals	显示当前作用域内的局部变量及实时值。
全局变量	查看工程中的全局变量值。
断点	查看当前已设置的断点列表，并可启用、禁用或删除断点。

图中右侧调试面板展示了 Locals 变量，例如计数器、定时器状态和计算变量值。通过这些实时值可以判断程序是否按照预期执行。

单步调试

程序停在断点后，可以使用调试工具条进行单步操作：

1. 点击 单步，逐行执行当前程序语句。
2. 观察右侧变量值是否随语句执行发生变化。
3. 如果进入函数或功能块调用，可以继续单步分析内部逻辑。
4. 如果不需要继续查看当前调用层级，可以点击 跳出。
5. 点击 继续，让程序恢复运行到下一个断点。

管理断点

调试过程中可以根据需要管理断点：

• 在行号区域再次单击断点位置，可以取消该断点。
• 在右侧 断点 区域可以查看所有断点。
• 暂时不需要的断点可以禁用，后续再启用。
• 调试结束前建议清理不再使用的断点，避免下次调试时程序意外暂停。

使用建议

• 优先在状态切换、异常判断、输出赋值和功能块调用位置设置断点。
• 单步执行时同步观察局部变量和全局变量，确认变量值变化是否符合预期。
• 对周期性任务设置断点时，注意程序会随 PLC 扫描周期重复执行。
• 如果断点没有命中，请检查任务是否运行、程序是否被调用、断点所在逻辑分支是否满足条件。