您的当前位置:首页正文

VSCode中本地调试 Python 代码具体步骤

2024-12-01 来源:个人技术集锦

在VSCode中调试Python代码需安装Python解释器和VSCode,安装Python扩展,配置调试环境并创建launch.json文件,设置断点,启动调试。可查看变量、步进、继续执行、监视表达式并与控制台交互。根据需求调整launch.json配置以适应不同场景。

Visual Studio Code 的主要功能之一是其强大的调试支持。 的内置调试器有助于加速编辑、编译和调试循环。

一、 安装python-debugger插件

在插件库内搜索python Debugger,安装插件

二. 配置调试环境

创建一个 launch.json 文件来配置调试环境。这个文件告诉 VSCode 如何启动和连接到 Python 调试器。

  • 如果首次使用调试功能,VSCode 会提示您创建 launch.json。点击提示中的 “Create a launch.json file” 按钮,然后选择 “Python” 环境。

  • 如果已有 launch.json 文件,点击齿轮图标(或右键选择 “Add Configuration…”),然后选择 “Python”。

生成的 launch.json 文件通常包含一些预设的调试配置模板。您可以根据需要选择合适的配置(如 “Python File”、“Module” 或 “Integrated Terminal/Console”),或者自定义配置。

正常配置参数有如下这些:

  • "name":配置的名称,用于在调试面板中选择启动。

  • "type":调试器类型,这里应为 "python"

  • "request":请求类型,通常设为 "launch" 表示启动一个新的 Python 进程进行调试。

  • "program":要调试的主程序文件路径,"${file}" 表示当前打开的文件。

  • "console":输出调试信息的终端类型,可以是 "integratedTerminal"(集成终端)或 "internalConsole"(内部调试控制台)。

  • "justMyCode":是否只调试自己的代码,true 表示忽略外部库的代码。

  • "env":环境变量,可以在这里添加或覆盖需要传递给调试进程的环境变量。

  • "args":传递给调试程序的命令行参数。

这里是我在launch.json中添加的参数信息:

三、设置断点

在您想要调试的代码行号左侧单击,即可设置一个断点。断点标记为红色圆圈,表示当程序执行到这一行时会暂停。

设置好断点后,点击启动debug调试:

这里重点介绍下进入debug调试模式后,各个调试按钮的作用,最主要的是前四个按钮

  • F5:继续执行,直到遇到下一个断点或程序结束。

  • F10:Step Over,执行下一行代码,但不会进入函数或方法内部。

  • F11:Step Into,执行下一行代码,并进入函数或方法内部。

  • Shift + F11:Step Out,从当前函数或方法跳出,返回到调用处的下一行。

下面的是我本地的调试例子,可以在左侧视图中查看当前作用中变量或表达式的值,或者在终端中也可以打印变量或表达式的值

当程序运行到断点处时,将会暂停执行,此时可以进行以下操作:

  • 查看变量在 Variables 视图中查看当前作用域内的变量及其值。

  • 步进

         F10:Step Over,执行下一行代码,但不会进入函数或方法内部。

   F11:Step Into,执行下一行代码,并进入函数或方法内部。

   Shift + F11:Step Out,从当前函数或方法跳出,返回到调用处的下一行。

  • 继续执行:点击 Continue 按钮(或使用 F5)继续执行,直到遇到下一个断点或程序结束。

  • 监视表达式在 Watch 视图中添加或编辑表达式,观察其在调试过程中的值变化。

  • 控制台交互在调试控制台中(如集成终端)输入命令与当前调试环境交互,如打印变量、修改变量值等。

通过以上步骤,您就可以在 Visual Studio Code 中顺利地调试 Python 代码了。如有需要,可根据具体项目需求进一步调整 launch.json 配置,以适应不同的调试场景。

参考:

显示全文