3、调试工具界面总览：主窗口布局，菜单栏与工具栏，日志窗口，图像预览窗口，参数调节面板
好，咱们直接进入正题。调试工具长什么样？你第一次打开它，可能会觉得「东西好多」。别慌，我带你走一遍。
我个人习惯，拿到一个新工具，先看它的骨架——主窗口布局。这就像你进一个车间，先看工作台在哪、工具架在哪、物料区在哪。心里有数了，后面干活才顺手。
3.1 主窗口布局：四块「责任田」
这个调试工具的主窗口，说白了就是四个区域拼在一起。我当年第一次用的时候，觉得它像个「田字格」。你想想看：
- 左上：图像预览窗口。看算法输出结果的。
- 右上：参数调节面板。调各种阈值、权重的地方。
- 左下：日志窗口。算法运行时吐出来的文字信息。
- 右下：辅助信息区。有时候放直方图，有时候放特征列表。
嗯，这里要注意：这四个区域的大小是可以拖拽调整的。我在项目中遇到过，有的同事把日志窗口拖得特别小，结果出了错都看不见报错信息，白白浪费半天时间。我的建议是——日志窗口至少占四分之一的高度，别省这点空间。
核心原则：布局的优先级是「信息可读性」>「操作便利性」>「视觉美观」。别为了好看把字缩到蚂蚁大小。
3.2 菜单栏与工具栏：你的「瑞士军刀」
菜单栏在顶部，工具栏在菜单栏下面。这俩东西，说白了就是你把所有操作分类放好的地方。
菜单栏，我习惯把它分成三组：
| 菜单组 | 常用功能 | 我的经验 |
|---|---|---|
| 文件 | 加载算法、保存配置、导出结果 | 每次调参前先「保存配置」，我曾经手滑关掉窗口，半天白干 |
| 调试 | 单步执行、断点管理、变量监视 | 单步执行配合日志窗口，是定位故障的黄金组合 |
| 视图 | 切换布局、显示/隐藏面板 | 如果你屏幕小，可以临时关掉图像预览，专注看日志 |
工具栏，就是把菜单里最常用的几个功能拎出来，放上图标。我个人习惯只保留五个按钮：运行、暂停、单步、重置、保存截图。太多按钮反而眼花，你想想看，是不是这个道理？
小技巧：工具栏上的图标，鼠标悬停会显示文字提示。如果你不确定某个按钮是干嘛的，别乱点，先悬停看提示。我曾经有个同事，把「重置」当成「刷新」点了，结果跑了两个小时的调试数据全没了……
3.3 日志窗口：算法的「黑匣子」
日志窗口，是我最依赖的地方。它记录着算法每一步干了什么、出了什么错。说白了，它就是算法的「黑匣子」。
日志一般分四个级别，我用一个表格给你说清楚：
| 级别 | 颜色 | 含义 | 你该怎么做 |
|---|---|---|---|
| DEBUG | 灰色 | 详细的调试信息 | 平时可以关掉，定位具体问题时再打开 |
| INFO | 白色/黑色 | 正常运行的提示 | 看一眼就行，不用太在意 |
| WARNING | 黄色 | 可能有隐患，但没出错 | 别忽略，我曾经因为忽略一个 warning，导致后续结果全偏 |
| ERROR | 红色 | 出错了，算法跑不下去 | 立刻停下来，看错误信息 |
嗯，这里有个坑。日志窗口默认只显示最近几百条记录。如果你的算法跑了几万步，前面的日志会被冲掉。怎么办？
- 方法一：在设置里把日志缓存调大，比如调到 10000 条。
- 方法二：把日志实时导出到文件。我习惯用这个方法，因为可以事后慢慢翻。
避坑指南：我曾经调试一个图像分割算法，日志窗口一直报 WARNING，但没报 ERROR。我以为是小事，结果跑了两个小时，出来的分割结果全是错的。后来发现，那个 WARNING 是在提示「输入图像尺寸异常，已自动裁剪」。裁剪后的图像根本不是我要处理的内容……所以，WARNING 一定要点开看详情，别只看颜色。
3.4 图像预览窗口：算法的「眼睛」
图像预览窗口，就是让你看到算法「看到了什么」。对于 3A 算法来说，这个窗口至关重要。因为很多问题，光看数字是看不出来的，必须看图像。
这个窗口一般支持几种显示模式：
- 原图模式：显示输入图像，不做任何处理。
- 结果图模式：显示算法处理后的输出。
- 叠加模式：把原图和结果图叠在一起，方便对比。
- 差异图模式：显示原图和结果图的差异区域，故障定位时特别好用。
我个人最常用的是「差异图模式」。举个例子，有一次我调试自动白平衡算法，看结果图觉得颜色挺正常的，但切换到差异图一看，发现画面左上角有一块区域的颜色偏差特别大。顺着这个线索，我找到了一个边界处理的 bug。
小技巧：图像预览窗口支持鼠标滚轮缩放。按住 Ctrl + 滚轮，可以放大局部细节。我习惯先看整体，再放大看可疑区域。
3.5 参数调节面板：算法的「方向盘」
参数调节面板，就是你调算法参数的地方。它一般以列表或滑块的形式展示所有可调参数。
我把它分成三类：
| 参数类型 | 例子 | 调节方式 | 注意事项 |
|---|---|---|---|
| 连续型 | 增益值、阈值 | 滑块拖动 | 注意步长，步长太大容易跳过最优值 |
| 离散型 | 算法模式、滤波器类型 | 下拉菜单 | 切换后记得看日志，确认模式生效 |
| 开关型 | 是否启用后处理、是否输出调试图 | 复选框 | 调试时建议打开所有开关，正式跑时再关 |
嗯，这里要特别说一句：参数调节面板的「重置」按钮，不是「恢复默认值」，而是「恢复到你上次保存的配置」。我第一次用的时候没注意，点了重置，结果参数回到了三天前的状态……从那以后，我每次调参前都会先点一下「保存当前配置」。
3.6 整体结构图：一张图看懂所有
说了这么多，我画一张图帮你串起来。这张图就是调试工具的整体结构，你对照着看，心里就有谱了。
这张图里，从上到下依次是菜单栏、工具栏，然后是四个核心区域。你每次打开工具，先扫一眼这四个区域的状态，心里就有数了。
3.7 我的日常操作流程
最后，分享一下我每天打开调试工具后的操作顺序。不是什么金科玉律，但至少能帮你少走弯路：
- 先看日志窗口：有没有残留的 ERROR 或 WARNING？有的话先处理，别急着跑。
- 检查参数面板：当前参数是不是我上次保存的？不是的话，加载保存的配置。
- 加载测试图像：选一张有代表性的图，别选纯色图，那种图看不出问题。
- 运行一次：看图像预览窗口的结果，同时盯着日志窗口的输出。
- 调参：每次只改一个参数，改完立刻看效果。别一次改三个，出了问题你都不知道是哪个引起的。
嗯，这套流程我用了好几年，基本没出过大问题。你刚开始用的时候，也可以照着来。等熟练了，再根据自己的习惯调整。