使用 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 中开始调试。
调试器用户界面
下图显示了调试器用户界面的主要组件
- 运行和调试视图:显示与运行、调试和管理调试配置设置相关的所有信息。
- 调试工具栏:包含最常用调试操作的按钮。
- 调试控制台:可以查看在调试器中运行的代码的输出并与之交互。
- 调试侧边栏:在调试会话期间,让您可以与调用堆栈、断点、变量和监视变量进行交互。
- 运行菜单:包含最常用的运行和调试命令。
开始调试之前
-
为您的语言或运行时从 Visual Studio Marketplace 安装一个调试扩展。
VS Code 内置了对 JavaScript、TypeScript 和 Node.js 调试的支持。
-
为您的项目定义一个调试配置。
对于简单的应用程序,VS Code 会尝试运行和调试当前活动的文件。对于更复杂的应用程序或调试场景,您需要创建一个
launch.json
文件来指定调试器配置。获取有关创建调试配置的更多信息。提示VS Code 中的 Copilot 可以帮助您生成
launch.json
文件。有关更多信息,请参阅使用 Copilot 生成调试配置。 -
在您的代码中设置断点。
断点是您可以在代码行上设置的标记,用于告诉调试器在执行到达该行时暂停。您可以通过单击编辑器中行号旁边的边栏来设置断点。
有关断点的更多信息,请参阅使用断点。
启动调试会话
要在 VS Code 中启动调试会话,请执行以下步骤
-
打开包含您要调试的代码的文件。
-
使用 F5 键启动调试会话,或在运行和调试视图 (
workbench.view.debug
) 中选择运行和调试。对于更复杂的调试场景,如附加到正在运行的进程,您需要创建一个
launch.json
文件来指定调试器配置。获取有关调试配置的更多信息。 -
从可用调试器列表中选择您要使用的调试器。
VS Code 会尝试运行和调试当前活动的文件。对于 Node.js,VS Code 会检查
package.json
文件中的start
脚本以确定应用程序的入口点。 -
当调试会话开始时,会显示调试控制台面板并显示调试输出,状态栏会改变颜色(默认颜色主题为橙色)。
-
状态栏中的调试状态显示活动的调试配置。选择调试状态可以更改活动的启动配置并开始调试,而无需打开运行和调试视图。
调试操作
调试会话开始后,调试工具栏会出现在窗口顶部。该工具栏包含控制调试会话流程的操作,例如单步执行代码、暂停执行和停止调试会话。
下表描述了调试工具栏中可用的操作
操作 | 描述 |
---|---|
继续 / 暂停 F5 |
继续:恢复正常的程序/脚本执行(直到下一个断点)。 暂停:检查当前行正在执行的代码并逐行调试。 |
单步跳过 F10 |
将下一个方法作为单个命令执行,而不检查或跟踪其组件步骤。 |
单步进入 F11 |
进入下一个方法以逐行跟踪其执行。 |
单步跳出 ⇧F11 (Windows, Linux Shift+F11) |
在方法或子程序内部时,通过将当前方法的剩余行当作单个命令一样完成,返回到早前的执行上下文。 |
重启 ⇧⌘F5 (Windows, Linux Ctrl+Shift+F5) |
终止当前程序执行,并使用当前的运行配置再次开始调试。 |
停止 ⇧F5 (Windows, Linux Shift+F5) |
终止当前程序执行。 |
如果您的调试会话涉及多个目标(例如,一个客户端和一个服务器),调试工具栏会显示会话列表并让您在它们之间切换。
使用 debug.toolBarLocation 设置来控制调试工具栏的位置。它可以是默认的 floating
(浮动),docked
(停靠)到运行和调试视图,或 hidden
(隐藏)。浮动的调试工具栏可以水平拖动,也可以向下拖动到编辑器区域(距离顶部边缘有一定距离)。
Breakpoints
断点是一个特殊的标记,它会在代码的特定点暂停执行,以便您可以在该点检查应用程序的状态。VS Code 支持多种类型的断点。
设置断点
要设置或取消断点,请单击编辑器边栏或在当前行上使用 F9。
- 编辑器边栏中的断点通常显示为红色的实心圆。
- 禁用的断点有一个灰色的实心圆。
- 当调试会话开始时,无法在调试器中注册的断点会变成一个灰色的空心圆。如果在一个不支持实时编辑的调试会话运行时编辑了源代码,也可能发生同样的情况。
通过启用设置 debug.showBreakpointsInOverviewRuler,可以选择性地在编辑器的概览标尺中显示断点
要更好地控制您的断点,请使用运行和调试视图的断点部分。此部分列出了您代码中的所有断点,并提供了额外的操作来管理它们。
断点类型
条件断点
VS Code 一个强大的调试功能是能够基于表达式、命中次数或两者的组合来设置条件。
- 表达式条件:每当表达式的计算结果为
true
时,断点就会被命中。 - 命中次数:命中次数控制了断点需要被命中多少次才会中断执行。是否遵循命中次数以及表达式的确切语法可能因调试器扩展而异。
- 等待断点:当另一个断点被命中时,此断点才会被激活(触发断点)。
要添加条件断点
-
创建一个条件断点
- 在编辑器边栏中右键单击并选择添加条件断点。
- 在命令面板 (⇧⌘P (Windows, Linux Ctrl+Shift+P)) 中使用添加条件断点命令。
-
选择您要设置的条件类型(表达式、命中次数或等待断点)。
要为现有断点添加条件
-
编辑现有断点
- 在编辑器边栏中的断点上右键单击并选择编辑断点。
- 在运行和调试视图的断点部分中,为现有断点选择铅笔图标。
-
编辑条件(表达式、命中次数或等待断点)。
如果调试器不支持条件断点,添加条件断点和编辑条件操作将不可用。
触发断点
触发断点是一种条件断点,它在另一个断点被命中后才启用。它们在诊断仅在满足特定前提条件后才发生的代码故障时非常有用。
可以通过右键单击字形边距,选择 添加触发断点,然后选择哪个其他断点启用此断点来设置触发断点。
内联断点
只有当执行到达与内联断点关联的列时,才会命中内联断点。这在调试包含单行多条语句的压缩代码时非常有用。
可以使用 ⇧F9 (Windows, Linux Shift+F9) 或在调试会话期间通过上下文菜单来设置内联断点。内联断点会在编辑器中内联显示。
内联断点也可以有条件。可以通过编辑器左侧边栏的上下文菜单编辑一行上的多个断点。
函数断点
调试器可以支持通过指定函数名来创建断点,而不是直接在源代码中放置断点。这在源代码不可用但函数名已知的情况下很有用。
要创建函数断点,请选择断点部分标题中的 + 按钮并输入函数名。函数断点在断点部分中以红色三角形显示。
数据断点
如果调试器支持数据断点,可以从变量视图的上下文菜单中设置它们。值更改/读取/访问时中断命令会添加一个数据断点,当基础变量的值更改/被读取/被访问时,该断点会被命中。数据断点在断点部分中以红色六边形显示。
日志点
日志点是断点的一种变体,它不会中断到调试器,而是在调试控制台中记录一条消息。日志点可以帮助您节省时间,因为您无需在代码中添加或删除日志语句。
日志点由一个菱形图标表示。日志消息是纯文本,但也可以包含在大括号 ('{}') 内进行求值的表达式。
要添加日志点,请在编辑器左侧边栏右键单击并选择添加日志点,或在命令面板 (⇧⌘P (Windows, Linux Ctrl+Shift+P)) 中使用调试: 添加日志点... 命令。您还可以配置设置 debug.gutterMiddleClickAction,以便在编辑器边栏中按下鼠标中键时切换日志点。
与常规断点一样,日志点可以启用或禁用,也可以由条件和/或命中次数控制。
调试器扩展可以选择是否实现日志点。
数据检查
运行和调试视图
在调试会话期间,您可以在运行和调试视图的变量部分检查变量和表达式,或者通过将鼠标悬停在编辑器中的源代码上来检查。变量值和表达式求值是相对于调用堆栈部分中选定的堆栈帧而言的。
要在调试会话期间更改变量的值,请在变量部分中右键单击该变量并选择设置值 (Enter (Windows, Linux F2))。
此外,您可以使用复制值操作来复制变量的值,或使用复制为表达式操作来复制访问该变量的表达式。然后您可以在监视部分使用此表达式。
变量和表达式也可以在运行和调试视图的监视部分中进行求值和监视。
要按名称或值筛选变量,请在焦点位于变量部分时使用 ⌥⌘F (Windows, Linux Ctrl+Alt+F) 键盘快捷键,然后键入搜索词。
调试控制台 REPL
可以使用调试控制台 REPL (读取-求值-打印循环) 功能来求值表达式。要打开调试控制台,请使用调试窗格顶部的调试控制台操作或使用视图: 调试控制台命令 (⇧⌘Y (Windows, Linux Ctrl+Shift+Y))。
在您按下 Enter 键后,表达式会被求值,调试控制台 REPL 会在您键入时显示建议。如果您需要输入多行,请在行之间使用 Shift+Enter,然后用 Enter 发送所有行进行求值。
调试控制台输入使用活动编辑器的模式,这意味着调试控制台输入支持语法高亮、缩进、引号自动闭合以及其他语言功能。
您必须处于活动的调试会话中才能使用调试控制台 REPL。
多目标调试
对于涉及多个进程(例如,一个客户端和一个服务器)的复杂场景,VS Code 支持多目标调试。在启动第一个调试会话后,您可以启动另一个调试会话。一旦第二个会话启动并运行,VS Code UI 会切换到多目标模式
-
各个会话现在在调用堆栈视图中显示为顶级元素。
-
调试工具栏显示当前活动会话(所有其他会话都可以在下拉菜单中找到)。
-
调试操作(例如,调试工具栏中的所有操作)都在活动会话上执行。可以通过使用调试工具栏中的下拉菜单或在调用堆栈视图中选择不同的元素来更改活动会话。
远程调试
VS Code 不支持跨所有语言的内置远程调试。远程调试是您正在使用的调试扩展的功能,您应该查阅该扩展在 Marketplace 上的页面以获取支持和详细信息。
然而,有一个例外:VS Code 中包含的 Node.js 调试器支持远程调试。有关更多信息,请参阅 Node.js 调试。
调试器扩展
VS Code 内置了对 Node.js 运行时的调试支持,并且可以调试 JavaScript、TypeScript 或任何其他可转译为 JavaScript 的语言。
要调试其他语言和运行时(包括 PHP、Ruby、Go、C#、Python、C++、PowerShell 和许多其他语言),请在 Visual Studio Marketplace 中查找 Debuggers
扩展,或在顶层“运行”菜单中选择安装其他调试器。
以下是几个包含调试支持的流行扩展
后续步骤
要了解 VS Code 的 Node.js 调试支持,请查看
- Node.js - 描述了 VS Code 中包含的 Node.js 调试器。
- TypeScript - Node.js 调试器也支持 TypeScript 调试。
要观看关于调试基础的教程,请查看此视频
- 在 VS Code 中开始调试 - 了解在 VS Code 中进行调试。
要了解更多关于 Copilot 和 VS Code 中 AI 辅助调试的信息
要了解通过 VS Code 扩展对其他编程语言的调试支持
要了解 VS Code 的任务运行支持,请访问
- 任务 - 描述了如何使用 Gulp、Grunt 和 Jake 运行任务,以及如何显示错误和警告。
要编写您自己的调试器扩展,请访问
- 调试器扩展 - 使用一个模拟示例来说明创建 VS Code 调试扩展所需的步骤。
常见问题
支持哪些调试场景?
VS Code 开箱即用地支持在 Linux、macOS 和 Windows 上调试基于 Node.js 的应用程序。Marketplace 中提供的 VS Code 扩展支持许多其他场景。