vscode如何调试python

在VSCode中调试Python代码，可以通过安装Python扩展、配置启动配置文件、设置断点和使用调试控制台等步骤来实现。安装Python扩展是第一步，它提供了Python的语法高亮、代码自动完成和调试功能；其次，调试之前需要创建launch.json文件来配置调试环境；然后，在代码中设置断点，通过F5快捷键启动调试模式；最后，使用调试控制台来监控变量和执行流程。安装Python扩展、配置launch.json文件、设置断点和使用调试控制台是VSCode调试Python的四个关键步骤。

一、安装Python扩展

VSCode本身是一款功能强大的代码编辑器，但是为了支持不同的编程语言，它需要安装相应的扩展。对于Python开发者来说，Python扩展是必不可少的。

安装Python扩展

打开VSCode，在左侧活动栏中点击扩展图标（或使用快捷键Ctrl+Shift+X），在搜索框中输入“Python”，选择由Microsoft提供的Python扩展并安装。这个扩展提供了调试支持、代码自动完成、Linting、Jupyter支持等多种功能。
验证安装

安装完成后，重启VSCode。打开一个Python文件，如果扩展安装正确，您应该可以看到代码有语法高亮，并且在底部状态栏中会显示当前使用的Python版本。

二、配置launch.json文件

launch.json文件是VSCode中调试配置文件，它定义了调试程序的启动方式、参数等信息。

创建launch.json文件

在VSCode中按下F5键，系统会提示选择调试环境。选择“Python File”，VSCode会自动生成一个launch.json文件并将其保存在.vscode文件夹中。

配置调试参数

launch.json文件中包含多种调试配置项，您可以根据需要进行调整。例如，"program"字段用于指定要调试的Python文件路径，"args"字段用于传递命令行参数。

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Current File",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal"
        }
    ]
}

工作目录和环境变量

您可以通过"env"字段设置环境变量，通过"cwd"字段设置工作目录。这些设置在需要特定运行环境的项目中非常有用。

三、设置断点

断点是调试过程中用于暂停程序运行的位置，以便观察代码行为和变量状态。

如何设置断点

在VSCode中，您可以通过点击行号左侧的灰色区域来设置断点。设置后，断点会以红色圆点显示。
条件断点

在某些情况下，您可能只希望在特定条件下暂停执行。右键单击断点图标，可以选择“编辑断点”，输入条件表达式。只有当条件为真时，程序才会暂停。
管理断点

您可以通过调试面板管理所有断点，包括启用、禁用和删除断点。调试面板位于调试工具栏的顶部。

四、使用调试控制台

调试控制台是VSCode调试功能的重要组成部分，它用于在调试过程中检查变量值、执行表达式和查看输出。

启动调试

设置好断点后，按F5键启动调试模式。程序会在第一个断点处暂停，您可以在调试控制台中查看当前变量的值。
调试工具栏

调试工具栏提供了多种控制选项，包括继续执行、单步执行（F10）、进入函数（F11）和退出函数（Shift+F11）等。您可以根据需要选择合适的操作。
监视变量

在调试过程中，您可以将感兴趣的变量添加到“监视”窗口。右键单击变量选择“添加到监视”，这样可以在调试过程中实时查看变量的变化。
执行表达式

调试控制台支持直接输入和执行Python表达式。您可以用它来验证假设、查看函数返回值或临时计算数据。

五、分析调试输出

调试不仅仅是暂停和查看代码，还包括分析输出和错误信息，以便更好地理解程序行为。

控制台输出

调试时，程序的标准输出和错误输出会显示在调试控制台中。仔细阅读这些输出有助于发现和解决问题。
异常处理

当程序抛出异常时，VSCode会自动暂停在异常发生的位置。您可以查看调用堆栈、变量状态来分析问题原因。
日志信息

在复杂项目中，您可能会使用日志记录程序的运行状态。通过调试，您可以更好地关联日志信息和代码行为。

六、调试远程Python应用

VSCode不仅支持本地调试，还可以调试运行在远程服务器上的Python应用。

准备远程环境

在远程服务器上，确保安装了Python解释器，并通过SSH或其他方式可以访问。
配置SSH

在VSCode中安装Remote – SSH扩展，通过SSH连接到远程服务器。连接成功后，您可以在VSCode中像操作本地文件一样编辑和调试远程文件。

设置远程调试配置

在launch.json中，配置远程调试参数，如host、port等。确保远程Python应用的调试端口开放并可以访问。

{
    "name": "Remote Debug",
    "type": "python",
    "request": "attach",
    "connect": {
        "host": "remote-server-ip",
        "port": 5678
    },
    "pathMappings": [
        {
            "localRoot": "${workspaceFolder}",
            "remoteRoot": "/path/to/remote/workspace"
        }
    ]
}