4、单步调试：Step Over、Step Into、Step Out、Run to Cursor、Jump to Line 的实战应用

调试器里的这几个按钮，说白了就是你的「放大镜」和「手术刀」。

我刚入行那会儿，总觉得调试就是打几个 qDebug() 完事。直到有一次，一个诡异的野指针问题让我熬了三个通宵……嗯，从那以后，我再也不敢小看单步调试了。

4.1 Step Over（单步跳过）—— 最常用的「跨步」

Step Over 的快捷键是 F10（Qt Creator 默认）。它的意思是：执行当前行，如果遇到函数调用，一口气执行完，不进去看。

举个例子，你写了个计算价格的函数：

double total = calculatePrice(quantity, discount);  // 断点停在这里
qDebug() << "总价：" << total;

按 F10，调试器会直接执行 calculatePrice 并返回结果，然后停在下一行。你不需要关心 calculatePrice 里面有多少循环、多少判断。

4.2 Step Into（单步进入）—— 钻进函数内部

Step Into 的快捷键是 F11。它的作用是：如果当前行有函数调用，就跳进这个函数的第一行代码。

我曾经遇到过一个 bug：某个字符串处理函数偶尔会崩溃。用 Step Over 根本看不出问题，因为函数执行完就直接崩了。这时候我按了 F11，钻进去一看——好家伙，有个指针没判空就直接用了。

QString processName(const QString& raw) {
    // 断点停在这里
    if (raw.isEmpty()) {  // 我按 F11 进来后，发现这里根本没走到
        return "default";
    }
    // ... 后续处理
}

4.3 Step Out（单步跳出）—— 快速「脱身」

Step Out 的快捷键是 Shift+F11。它的作用是：执行完当前函数的剩余代码，然后跳回到调用处。

这个功能特别实用。你想想看，有时候你钻进一个函数，看了几行就发现不是这里的问题。难道要一行一行按 F10 走完整个函数？太傻了。直接按 Shift+F11，瞬间回到上一层。

4.4 Run to Cursor（运行到光标处）—— 精准「空降」

Run to Cursor 的快捷键是 Ctrl+F10（或右键菜单选择）。它的意思是：从当前位置直接执行到光标所在行，中间不停。

这个功能我几乎每天都在用。比如你调试一个循环，已经确认前 100 次都没问题，但第 101 次会出错。你难道要按 100 次 F5 吗？当然不。

for (int i = 0; i < 1000; ++i) {
    processItem(list[i]);  // 断点停在这里
    // 我想直接跳到 i == 100 的位置
}

你只需要在 i == 100 的那一行设个临时断点，或者直接把光标移到那一行，按 Ctrl+F10。调试器会一口气执行到那里，然后停下来等你。

4.5 Jump to Line（跳转到行）—— 强制「穿越」

Jump to Line 是个隐藏技能。在 Qt Creator 里，你可以在调试时按住 Ctrl 键，然后拖动代码左侧的黄色箭头，把它拖到任意一行。

这个操作的意思是：强制改变执行流程，跳过某些代码，或者重复执行某些代码。

我什么时候用它？举个例子：你有一个函数，里面有个复杂的 if-else 分支。你已经在调试模式下了，想测试某个分支的逻辑，但触发条件很难满足。这时候，直接把箭头拖到那个分支的第一行，强制执行。

if (userType == "admin") {
    // 我想测试这里，但 userType 一直是 "guest"
    grantAdminAccess();
} else {
    showAccessDenied();
}

把箭头拖到 grantAdminAccess() 那一行，然后按 F10 继续。这样就能在不修改代码的情况下，测试到平时很难触发的代码路径。

4.6 五个功能的对比总结

功能	快捷键	核心用途	我什么时候用
Step Over	F10	跳过函数，只看结果	验证主流程逻辑
Step Into	F11	钻进函数内部	怀疑函数内部有 bug
Step Out	Shift+F11	快速跳出函数	确认问题不在当前函数
Run to Cursor	Ctrl+F10	直接跳到指定行	跳过大量循环或无关代码
Jump to Line	拖拽箭头	强制改变执行顺序	测试难以触发的分支

4.7 实战演练：一个完整的调试场景

假设你有一个这样的代码：

void MainWindow::onButtonClicked() {
    QString input = ui->lineEdit->text();       // 行1
    QString result = processInput(input);        // 行2
    updateUI(result);                            // 行3
    saveToFile(result);                          // 行4
}

你在行1设了断点。现在开始调试：

1. 按 F10（Step Over），执行行1，停在行2。你看到 input 的值是 "abc"。
2. 按 F11（Step Into），钻进 processInput 函数。你发现里面有个字符串替换逻辑。
3. 看了几行，发现替换逻辑没问题。按 Shift+F11（Step Out），跳回行3。
4. 现在停在行3。你想看看 updateUI 执行后的效果，但不想看它的内部实现。按 F10，跳过。
5. 停在行4。你怀疑 saveToFile 有问题。把光标移到 saveToFile 内部某一行，按 Ctrl+F10（Run to Cursor），直接跳进去。
6. 发现文件路径拼接有误。你想测试另一种路径写法。把黄色箭头拖到路径拼接的下一行（Jump to Line），跳过错误的拼接代码。

你看，五个功能配合使用，效率非常高。

可可精品资料库