Python程序员Visual Studio Code指南5调试

游鸿斌

5 调试

当运行程序时终端输出错误时，可以参考编辑器中的"问题"面板来解决遇到的问题。不过，并非所有错误都会导致错误。可能出现的情况是，程序执行成功，但输出结果与预期不同。出现这种情况时，下一步就是找出程序中的错误。这个过程被称为调试。
您可以尝试通过注释代码行（从而禁止代码块运行）、添加更多打印语句以在代码块执行后输出，或修改程序中的行来定位和解决问题。虽然每种方法都能帮助你找出错误和可能的修复方法，但这一过程效率很低。
Visual Studio Code有内置调试器，它的功能通过Python扩展得到了进一步扩展。虽然调试器可以帮助您识别和修复错误，但您仍有责任识别错误可能出现在代码的哪个位置。一旦你确定了错误的潜在位置，就可以使用调试器来帮助你跟踪程序的执行状态。
5.1 启动调试

要让调试器在执行过程中暂停，必须在代码的某一行设置断点。只要你想检查程序的运行状态，然后逐行检查代码，就可以设置断点。在 Visual Studio 代码中，断点会以红点的形式出现在编辑器空白处。当调试会话开始时，调试器会执行到断点为止的所有代码行，并高亮显示要执行的下一行。(如果是步进操作，则例外，这将在后面的 "调试命令 "一节中解释）。

要添加断点，请将鼠标悬停在当前代码行的编辑器边框上，然后单击以添加断点。或者，使用键盘快捷键F9来添加当前代码行。要移除断点，请在编辑器空白处选择断点，或再次按F9键。也可以在顶部菜单中选择运行，然后选择移除所有断点，从而移除所有断点。
你可以在会话期间暂停调试器的任何位置调用debugypy.breakpoint()来强制设置断点。如果要强制设置断点，必须在代码中导入debuypy。调用后，调试器会停止下一行代码。这种方法会在程序中硬编码断点。如果你有一些异步的回调函数，而你又不想用其他断点来设置、清除、启用或禁用它们，那么这种方法可能会很有用。通过对几个断点进行硬编码，就能在回调函数发生时捕捉到它们。
您可以通过以下方式启动调试会话：

• 菜单： 选择运行 ➪ 启动调试。
  
• 键盘快捷键： 按 F5。
  
• 运行视图： 单击运行和调试
  

• 运行视图： 单击 "开始调试"（在调试会话启动后出现）
  

编辑器在调试会话期间的行为由调试配置控制。调试配置是调试器功能的设置列表。Python 扩展提供了几种配置，稍后将在 "启动配置 "中探讨。本章练习中出现提示时，点击 Python 文件配置，调试当前活动的 Python 文件。

启动调试会话后，会打开运行视图。运行视图用于管理调试会话。当调试会话处于活动状态时，"运行 视图中的面板会根据正在执行的内容动态变化。

当代码中添加断点时，断点面板会将模块名称（如times_two.py）及其相应的断点行添加到列表中。目前times_two.py 中有两个断点，一个在第4行，另一个在第6行。在断点面板中选择其中一个断点，编辑器就会高亮显示该断点。

假设你在程序中设置了多个断点。在调试时，你决定在会话中只选择一些断点，这样就不必在每个断点都暂停调试器了。移除不需要的断点会删除断点，如果你打算在后续调试会话中保留断点，这可能不是你的本意。相反，你可以禁用断点。在 "断点"面板中，取消选中断点旁边的方框即可禁用断点。或者，你也可以右键单击断点，然后单击禁用断点。如果想一次性禁用所有断点，可以单击"停用断点"按钮。不过，如果您想删除所有断点，请单击"删除断点"按钮。删除所有断点有助于确保清除程序中设置的所有断点。

调试器运行时，变量的当前状态会反映在变量面板中。变量面板将变量分为局部和全局范围。

在继续调试的过程中，请注意面板中变量的变化情况。虽然变量会随着程序的执行而填充，但变量值有可能会产生错误，从而导致代码停止执行。如果你发现换一个值就能继续执行程序，你可以在变量面板中更改该值。要更改数值，请选中变量并按Enter键。输入新变量后，再按一次Enter键，将修改后的值保存到程序状态中。
5.2 调试命令

除运行视图外，编辑器中还会出现调试工具栏（见图 5.9）。调试工具栏提供了对这些调试命令的快速访问：

• A—Continue (F5)
  
• B—Step Over (F10)
  
• C—Step Into (F11)
  
• D—Step Out (Shift+F11)
  
• E—Restart (Shift+Cmd/Ctrl+F5)
  
• F—Stop (Shift+F5)
  

调试命令是一起工作的，而不是独立的；也就是说，你通常要使用多种命令的组合来调试不同的代码行。
除调试工具栏命令外，编辑器右键上下文菜单中还提供了其他命令。这些功能包括

• 添加内联断点(Add Inline Breakpoint)-在代码中添加断点，特别是在光标下的代码中。这对单个语句中的复合表达式非常有用，因为您希望在表达式的特定部分断开。或者，您可以导航到运行 ➪ 新断点 ➪ 内联断点，或者使用键盘快捷键 Shift+F9。
  
• 运行到光标(Run to Cursor)-运行一段代码而不设置另一个断点。
  
• 跳转到光标(Jump to Cursor)-跳转代码行或返回并重复代码行。
  

5.2.1 Continue

当调试器停在某个断点时，单击"继续（Continue）"会运行该断点后的所有代码，直到下一个断点或程序结束。
5.2.2 Step Over

Step Over命令运行调试器当前暂停的代码行，然后自动暂停到下一行，无需另设断点。如果当前行是函数调用，调试器将运行整个函数，然后在函数调用后的下一行暂停。从本质上讲，Step Over命令是在当前范围内逐行进行调试。
试试看 运行调试器，逐行查看代码。注意，当调试器运行到 times_two() 函数定义处时，调试器的下一步是 print() 语句。
5.2.3 Step Into

当调试器在函数处暂停时，Step Into 命令会进入函数作用域。在这里，你可以查看函数作用域内的每一行，还能进入其他函数调用。

5.2.4 Step Out

如果发现自己想从函数内部退出到调用该函数的作用域，可以使用Step Out命令。
5.2.5 停止

在调试会话期间，可以使用Stop命令停止所有执行。停止会话会停止调试器，但不会结束程序。如果在调试会话期间发现了程序中的错误，并得出结论：如果继续执行，可能会产生影响程序的副作用，例如覆盖错误的文件。在这种情况下，请选择停止命令退出调试器。
5.2.5 重新启动

在调试和纠正程序中的错误时，你往往不想继续在当前（通常是错误的）状态下运行程序。这时，你需要停止执行并重新启动调试程序。重启（Restart）命令可以方便地停止调试器，保存当前文件，然后用最近的修改重新启动调试器。
参考资料

• 软件测试精品书籍文档下载持续更新 https://github.com/china-testing/python-testing-examples 请点赞，谢谢！
  
• 本文涉及的python测试开发库 谢谢点赞！ https://github.com/china-testing/python_cn_resouce
  
• python精品书籍下载 https://github.com/china-testing/python_cn_resouce/blob/main/python_good_books.md
  
• Linux精品书籍下载 https://www.cnblogs.com/testing-/p/17438558.html
  

5.3 调用堆栈

模块及其函数调用被称为框架。帧相互堆叠，当函数返回时，相应的帧会从堆栈中清除。以times_two.py程序为例，模块框架位于栈的底部，而times_two()函数框架位于栈的顶部。如果times_two()函数进行函数调用，被调用的函数将位于栈顶。调用栈本身被称为调用栈。
调试视图中的调用栈面板显示了导致当前执行点的整个函数调用链。调用栈面板列出了正在调试的文件和文件中正在运行的行。如果调用经过项目中的其他文件，调用堆栈尤其有用，因为调用堆栈会记录你在调试链中的位置。

此外，如果处于断点处，可以选择调用堆栈中的某一帧，变量面板会显示堆栈中该断点处的程序状态。这对于通过堆栈和生成该值的所有代码追溯错误值的源头非常有用。

逐行查看代码，直到调用times_two()函数。进入函数并注意调用堆栈。现在，times_two()框架已添加到调用堆栈中

调试器完成函数调用并返回总数后，times_two()框架将从调用栈面板中清除。
5.4 条件断点（Logpoints)

你可以配置断点，使其在特定条件为真时触发（条件断点），或在断点被触发一定次数后触发。
当你为断点指定的表达式求值为真时，条件断点就会断开。例如，如果要调试数据库中的数据，可以在出现特定记录时中断。
命中计数使调试器能够执行到指定的出现次数。Python扩展支持的命中计数是前面带有 、>、>=、 2 时的 elif 语句中，i == 1 似乎有问题。可以认为程序中的错误就出在这里。

• 在i == 1处设置断点并启动调试器。出现提示时，输入3。
  

调试器在断点处暂停后，查看变量面板，确认变量是否反映了适当的值。

• Step over到 while 循环的最后一行
  

注意到尽管已经生成了所需的斐波纳契数，循环仍开始了另一次迭代。继续跳过 while 循环，程序会生成相同的斐波纳契数，而且 while 循环从未中断过。该程序是一个无限循环。

• 启动调试器并打开调试控制台
  

调试器在断点处停止后，输入i+=1 以递增 i 的值。
在变量面板中，i 的值从 1 变为 2。 现在，继续调试程序时，执行代码的其余部分，只生成三个斐波那契数字。
5.7 启动配置

启动配置可让你配置不同调试会话的运行方式，并将这些配置持久保存在 launch.json 文件中。launch.json 文件保存在项目根目录下的 .vscode 文件夹中，也可在用户或工作区设置中访问。要进行调试，launch.json 文件中至少需要一个配置。
要创建 launch.json 文件，请在运行视图中单击创建 launch.json 文件。或者，你也可以从 "运行 "菜单中选择 "运行" ➪ "打开配置 "来创建 launch.json 文件。
Visual Studio Code会从命令面板打开配置菜单，提示您选择默认配置作为新配置的启动模板。

Python 扩展提供了以下默认配置：

• Python 文件-调试当前活动的 Python 文件。
  
• 模块-通过使用 -m 调用 Python 模块来调试该模块。
  
• 远程连接-为调试服务器监听提供主机名和端口号。
  
• 使用进程 ID 附加-当运行在 Visual Studio Code 之外启动的 Python 脚本时，将调试器附加到非调试模式下的 Python 进程。附加到进程需要进程 ID。
  

该扩展还为网络应用程序提供了三种默认配置：

• Django
  
• Flask
  
• Pyramid
  

要了解有关调试Django应用程序的更多信息，请参阅代码.visualstudio.com/docs/python/tutorial-django#_explore-the-debugger 的Django教程。要了解有关调试 Flask 应用程序的更多信息，请参阅位于 code.visualstudio.com/docs/python/tutorial-flask#_run-the-app-in-the-debugger 的 Flask 教程。
选择启动模板后，launch.json文件将添加到 .vscode 文件夹中，并在编辑器中打开。

编辑 launch.json 文件时，IntelliSense 会提示（Ctrl+空格键）可用属性列表。您也可以对文件中的所有属性使用悬停帮助。由于不同语言的属性可能不同，使用悬停帮助可以了解有关属性的更多信息。
launch.json 文件可以包含任意数量的配置。要添加配置，请从运行菜单或 launch.json 编辑器中单击添加配置。

这里提供了 launch.json 文件可用的核心设置：

• name -为出现在 Visual Studio 代码下拉列表中的调试配置提供名称。
  
• type-指定要使用的调试器类型；对于 Python 代码，将其设置为 python。
  
• request-指定开始调试的模式：
  
  
  
  • launch： 在程序中指定的文件上启动调试器。
    
  • attach（附加）： 将调试器附加到远程服务器上已经运行的进程上，该进程不能随意重启。本地需要与程序中指定的相同的源代码文件。
    
  
  
• program-提供 Python 程序入口模块（启动文件）的完整路径。默认配置中经常使用的 ${file} 值，会使用编辑器中的当前活动文件。通过指定启动文件，可以确保无论打开哪个文件，都能以相同的入口点启动程序。
  
• python- 指向用于调试的 Python 解释器的完整路径。如果未指定，则默认使用 python.pythonPath 设置中指定的解释器，相当于使用 ${config:python.pythonPath} 值。要使用其他解释器，请在调试配置的 python 属性中指定其路径。
  
• args-指定传递给程序的参数。参数字符串中以空格分隔的每个元素都应包含在引号中。
  
• cwd-指定调试器的当前工作目录，它是代码中使用的任何相对路径的基本文件夹。如果省略，当前工作目录默认为${workspaceFolder}，即编辑器中打开的文件夹。或者，也可以使用在每个平台上定义的自定义环境变量，其中包含要使用的 Python 解释器的完整路径，这样就不需要额外的文件夹路径了。
  

其他配置请访问 code.visualstudio.com/docs/python/debugging#_set-configuration-options。还有一些非Python 特有的附加属性，可以在 launch.json 中设置。要了解更多信息，请参阅 code.visualstudio.com/docs/editor/debugging#_launchjson-attributes。

来源:https://www.cnblogs.com/testing-/p/17640620.html
免责声明：由于采集信息均来自互联网，如果侵犯了您的权益，请联系我们【E-Mail:cb@itdo.tech】 我们会及时删除侵权内容，谢谢合作！