在 VS Code 中试试

使用 Visual Studio Code 调试代码

Visual Studio Code 为调试各种类型的应用程序提供了丰富的支持。VS Code 内置了对 JavaScript、TypeScript 和 Node.js 调试的支持。Visual Studio Marketplace 提供了各种调试扩展,可以为 VS Code 添加对其他语言和运行时的调试支持。

本文介绍了 VS Code 的调试功能以及如何在 VS Code 中开始调试。您还将学习如何利用 VS Code 中的 Copilot 加快设置调试配置和启动调试会话。

以下视频展示了如何在 VS Code 中开始调试。

调试器用户界面

以下图表显示了调试器用户界面的主要组件:

Debugging diagram

  1. 运行和调试视图:显示与运行、调试和管理调试配置设置相关的所有信息。
  2. 调试工具栏:包含最常用调试操作的按钮。
  3. 调试控制台:允许查看与调试器中运行的代码的输出进行交互。
  4. 调试侧边栏:在调试会话期间,允许您与调用堆栈、断点、变量和监视变量进行交互。
  5. 运行菜单:包含最常用的运行和调试命令。

开始调试之前

  1. Visual Studio Marketplace 为您的语言或运行时安装调试扩展。

    VS Code 内置了对 JavaScript、TypeScript 和 Node.js 调试的支持。

  2. 为您的项目定义调试配置。

    对于简单的应用程序,VS Code 会尝试运行和调试当前活动的文件。对于更复杂的应用程序或调试场景,您需要创建一个 launch.json 文件来指定调试器配置。获取有关创建调试配置的更多信息。

    提示

    VS Code 中的 Copilot 可以帮助您生成 launch.json 文件。有关更多信息,请参阅使用 Copilot 生成调试配置

  3. 在代码中设置断点。

    断点是您可以在代码行上设置的标记,用于告诉调试器在到达该行时暂停执行。您可以通过单击编辑器中行号旁边的边距来设置断点。

    有关断点的更多信息,请参阅使用断点

启动调试会话

要在 VS Code 中启动调试会话,请执行以下步骤:

  1. 打开包含要调试的代码的文件。

  2. F5 键或在运行和调试视图 (workbench.view.debug) 中选择运行和调试来启动调试会话。

    Simplified initial Run and Debug view

    对于更复杂的调试场景,例如附加到正在运行的进程,您需要创建一个 launch.json 文件来指定调试器配置。获取有关调试配置的更多信息。

  3. 从可用调试器列表中选择您想要使用的调试器。

    VS Code 会尝试运行和调试当前活动的文件。对于 Node.js,VS Code 会在 package.json 文件中检查 start 脚本,以确定应用程序的入口点。

  4. 调试会话开始时,会显示调试控制台面板,并显示调试输出,状态栏会改变颜色(默认颜色主题为橙色)。

    debug session

  5. 状态栏中的调试状态显示活动调试配置。选择调试状态可以更改活动的启动配置并开始调试,无需打开运行和调试视图。

    Debug status

调试操作

调试会话开始后,窗口顶部会出现调试工具栏。该工具栏包含用于控制调试会话流程的操作,例如单步执行代码、暂停执行和停止调试会话。

Screenshot that shows the Debug toolbar, with icons to control the flow of the debug session.

下表描述了调试工具栏中可用的操作:

操作 说明
继续 / 暂停
F5
继续:恢复正常的程序/脚本执行(直到下一个断点)。
暂停:检查当前行正在执行的代码并逐行调试。
单步跳过
F10
将下一个方法作为单个命令执行,不检查或跟随其组成步骤。
单步调试进入
F11
进入下一个方法,逐行跟随其执行。
单步调试退出
⇧F11(Windows、Linux Shift+F11
在方法或子程序内部时,通过完成当前方法的剩余行并将其视为单个命令来返回到先前的执行上下文。
重启
⇧⌘F5(Windows、Linux Ctrl+Shift+F5
终止当前程序执行,并使用当前运行配置再次开始调试。
停止
⇧F5(Windows、Linux Shift+F5
终止当前程序执行。

如果您的调试会话涉及多个目标(例如,客户端和服务器),调试工具栏会显示会话列表,并允许您在它们之间切换。

提示

使用debug.toolBarLocation 设置来控制调试工具栏的位置。它可以是默认的 floating(浮动),docked(停靠)在运行和调试视图中,或 hidden(隐藏)。浮动调试工具栏可以水平拖动,也可以向下拖动到编辑器区域(距离顶部边缘有一定距离)。

断点

断点是一种特殊的标记,它会在代码执行到特定位置时暂停,以便您可以在该点检查应用程序的状态。VS Code 支持多种类型的断点。

设置断点

要设置或取消设置断点,请单击编辑器边距或在当前行使用 F9

  • 编辑器边距中的断点通常显示为红色的实心圆。
  • 禁用的断点是灰色的实心圆。
  • 调试会话开始时,无法向调试器注册的断点会变成灰色的空心圆。如果在没有实时编辑支持的调试会话运行时编辑了源文件,也可能会发生同样的情况。

或者,可以通过启用设置 debug.showBreakpointsInOverviewRuler 在编辑器的概览尺中显示断点。

breakpoints in overview ruler

要更精细地控制断点,请使用运行和调试视图的断点部分。该部分列出了代码中的所有断点,并提供了额外的操作来管理它们。

Breakpoints

断点类型

条件断点

VS Code 调试的一个强大功能是能够根据表达式、命中次数或两者的组合设置条件。

  • 表达式条件:当表达式计算结果为 true 时,断点就会被命中。
  • 命中次数命中次数控制断点需要被命中多少次后才会中断执行。调试器扩展可能会有差异,是否支持命中次数以及表达式的确切语法也可能有所不同。
  • 等待断点:当命中另一个断点时,此断点会被激活(触发断点)。

添加条件断点

  1. 创建条件断点

    • 在编辑器边距中右键单击,然后选择添加条件断点
    • 在命令面板 (⇧⌘P (Windows, Linux Ctrl+Shift+P)) 中使用添加条件断点命令。
  2. 选择要设置的条件类型(表达式、命中次数或等待断点)。

    HitCount

为现有断点添加条件

  1. 编辑现有断点

    • 在编辑器边距中右键单击断点,然后选择编辑断点
    • 运行和调试视图的断点部分中,选择现有断点旁边的铅笔图标。
  2. 编辑条件(表达式、命中次数或等待断点)。

如果调试器不支持条件断点,则添加条件断点编辑条件操作不可用。

触发断点

触发断点是一种条件断点,它在命中另一个断点后才会启用。在诊断仅在满足特定前置条件后才会发生的代码失败情况时,它们会非常有用。

可以通过右键单击字形边距,选择添加触发断点,然后选择哪个其他断点启用此断点来设置触发断点。

内联断点

内联断点仅在执行到达与内联断点关联的列时才会命中。这在调试压缩的代码时非常有用,因为压缩的代码在一行中包含多个语句。

可以使用 ⇧F9(Windows、Linux Shift+F9 或在调试会话期间通过上下文菜单设置内联断点。内联断点会显示在编辑器的行内。

内联断点也可以有条件。可以通过编辑器左侧边距中的上下文菜单编辑一行上的多个断点。

函数断点

调试器可以支持通过指定函数名来创建断点,而不是直接在源代码中放置断点。这在源代码不可用但已知函数名的情况下非常有用。

要创建函数断点,请在断点部分的标题中选择 + 按钮并输入函数名。函数断点在断点部分中以红色三角形显示。

数据断点

如果调试器支持数据断点,可以在变量视图的上下文菜单中设置。在值更改/读取/访问时中断命令会添加一个数据断点,当底层变量的值更改/被读取/被访问时命中该断点。数据断点在断点部分中以红色六边形显示。

日志点

日志点是断点的一种变体,它不会中断到调试器中,而是将消息记录到调试控制台。日志点可以帮助您节省时间,无需在代码中添加或移除日志记录语句。

日志点由菱形图标表示。日志消息是纯文本,但也可以包含在大括号 ('{}') 中需要评估的表达式。

要添加日志点,请在编辑器左侧边距中右键单击并选择添加日志点,或在命令面板 (⇧⌘P (Windows, Linux Ctrl+Shift+P)) 中使用调试: 添加日志点... 命令。您还可以配置设置 debug.gutterMiddleClickAction,以便在编辑器边距中按下鼠标中键时切换日志点。

Logpoints

与常规断点一样,日志点可以启用或禁用,并且也可以由条件和/或命中次数控制。

注意

调试器扩展可以选择是否实现日志点。

数据检查

运行和调试视图

在调试会话期间,您可以在运行和调试视图的变量部分中检查变量和表达式,或者将鼠标悬停在编辑器中的源代码上。变量值和表达式评估是相对于调用堆栈部分中选定的堆栈帧的。

Screenshot of the Variables section in the Run and Debug view.

要在调试会话期间更改变量的值,请在变量部分中右键单击变量,然后选择设置值 (Enter (Windows, Linux F2))。

此外,您可以使用复制值操作复制变量的值,或者使用复制为表达式操作复制访问变量的表达式。然后您可以在监视部分中使用此表达式。

变量和表达式也可以在运行和调试视图的监视部分中进行评估和监视。

Screenshot of the Watch section in the Run and Debug view.

要按名称或值筛选变量,当焦点在变量部分时,使用键盘快捷方式 ⌥⌘F(Windows、Linux Ctrl+Alt+F,然后键入搜索词。

Screenshot of the filter control in the Variables section.

调试控制台 REPL

可以使用调试控制台的 REPL(读取-求值-打印循环)功能来评估表达式。要打开调试控制台,请使用调试窗格顶部的调试控制台操作或使用视图: 调试控制台命令 (⇧⌘Y(Windows、Linux Ctrl+Shift+Y)。

在您按下 Enter 后,表达式会被评估,调试控制台 REPL 会在您键入时显示建议。如果您需要输入多行,请在行之间使用 Shift+Enter,然后使用 Enter 发送所有行进行评估。

调试控制台输入使用活动编辑器的模式,这意味着调试控制台输入支持语法着色、缩进、自动闭合引号以及其他语言特性。

Screenshot of the Debug Console.

注意

您必须处于活动的调试会话中才能使用调试控制台 REPL。

多目标调试

对于涉及多个进程(例如客户端和服务器)的复杂场景,VS Code 支持多目标调试。在启动第一个调试会话后,您可以启动另一个调试会话。一旦第二个会话启动并运行,VS Code UI 就会切换到多目标模式

  • 现在,各个会话在调用堆栈视图中显示为顶级元素。

    Callstack View

  • 调试工具栏显示当前活动会话(所有其他会话可在下拉菜单中找到)。

    Debug Actions Widget

  • 调试操作(例如,调试工具栏中的所有操作)都在活动会话上执行。可以通过使用调试工具栏中的下拉菜单或在调用堆栈视图中选择不同的元素来更改活动会话。

远程调试

VS Code 不支持所有语言的内置远程调试。远程调试是您使用的调试扩展的功能,您应该查阅该扩展在市场中的页面以获取支持和详细信息。

但是,有一个例外:VS Code 中包含的 Node.js 调试器支持远程调试。有关更多信息,请参阅Node.js 调试

调试器扩展

VS Code 内置了对 Node.js 运行时的调试支持,并且可以调试 JavaScript、TypeScript 或任何其他转译为 JavaScript 的语言。

要调试其他语言和运行时(包括 PHPRubyGoC#PythonC++PowerShell 以及许多其他语言),请在 Visual Studio Marketplace 中搜索 Debuggers 扩展,或在顶层“运行”菜单中选择安装其他调试器

以下是几个包含调试支持的流行扩展:

后续步骤

要了解 VS Code 的 Node.js 调试支持,请参阅:

  • Node.js - 描述了包含在 VS Code 中的 Node.js 调试器。
  • TypeScript - Node.js 调试器也支持 TypeScript 调试。

要查看有关调试基础知识的教程,请观看此视频:

要详细了解 VS Code 中的 Copilot 和 AI 辅助调试,请参阅:

要了解通过 VS Code 扩展对其他编程语言的调试支持,请参阅:

要了解 VS Code 的任务运行支持,请访问:

  • 任务 - 描述了如何使用 Gulp、Grunt 和 Jake 运行任务,以及如何显示错误和警告。

要编写自己的调试器扩展,请访问:

  • 调试器扩展 - 使用一个模拟示例来演示创建 VS Code 调试扩展所需的步骤。

常见问题

支持哪些调试场景?

VS Code 内置支持在 Linux、macOS 和 Windows 上调试基于 Node.js 的应用程序。市场中提供的VS Code 扩展支持许多其他场景。