Python Visual Studio Code里调试运行Python代码

1. 介绍

Python Visual Studio Code（VS Code）是一款功能强大的集成开发环境（IDE），广泛被开发者用于编写Python代码。除了基本的编辑功能外，VS Code还提供了调试功能，可以帮助我们更方便地进行代码调试和错误排查。本文将详细介绍在VS Code中如何调试运行Python代码。

2. 安装和配置VS Code

首先，我们需要在官方网站（https://code.visualstudio.com/）上下载并安装VS Code。安装完成后，打开VS Code并按照提示进行基本配置，例如选择编辑器主题、选择默认编码等。

3. 安装Python扩展

为了能够在VS Code中运行Python代码并进行调试，我们需要安装Python扩展。在VS Code的扩展市场中搜索”Python”，选择Microsoft提供的Python扩展并点击安装。安装完成后，点击”重载（Reload）”按钮使扩展生效。

4. 新建Python项目

在VS Code中，我们可以通过创建一个空的文件夹来作为我们的Python项目文件夹。在文件菜单中选择”打开文件夹（Open Folder）”，然后选择一个合适的目录并点击”选择文件夹（Select Folder）”。

5. 创建Python文件

在Python项目文件夹中，我们可以通过右键点击空白处，然后选择”新建文件（New File）”来创建一个新的Python文件。为了演示调试功能，我们创建一个名为”hello.py”的Python文件，并写入以下代码：

def say_hello(name):
    message = "Hello, " + name + "!"
    print(message)

say_hello("World")

6. 配置调试器

要进行代码调试，我们需要对调试器进行一些配置。在VS Code的侧边栏中，点击”调试（Debug）”按钮以打开调试功能面板。然后，点击面板中的齿轮图标，选择”Python”作为调试器。此时VS Code会自动生成一个名为”launch.json”的配置文件。

在”launch.json”中，我们需要添加一个配置项来指定要调试的Python文件。打开”launch.json”文件，在”configurations”数组中添加以下代码段：

{
    "name": "Python Debug",
    "type": "python",
    "request": "launch",
    "program": "${workspaceFolder}/hello.py",
    "console": "integratedTerminal"
}

7. 启动调试

配置完成后，我们可以点击VS Code左上角的”开始调试（Start Debugging）”按钮来启动调试器。VS Code会自动在新窗口中打开一个终端，并运行我们的Python代码。

在终端中，我们可以看到输出了”Hello, World!”的结果，这是因为我们在代码中调用了say_hello("World")方法。此时，我们可以在代码中设置断点，通过单步执行等功能进行代码调试。

8. 断点

在调试器中，我们可以通过在代码上点击鼠标左键，设置断点。设置断点后，在调试开始时，代码会在断点位置暂停执行，以便我们查看变量的值、跟踪程序的执行流程等。

可以通过在代码的行数前面点击鼠标左键或使用F9键来设置或取消断点。断点会显示为红色圆圈，并标识出断点行。

9. 单步执行

除了设置断点，我们还可以通过单步执行功能逐行执行代码。在调试面板中，我们可以找到单步执行相关的按钮，例如”逐行执行（Step Over）”、”进入函数（Step Into）”、”跳过函数（Step Out）”等。

通过点击这些按钮，我们可以一步一步地执行代码，并观察变量的值和程序的执行流程。通过单步执行功能，我们可以更方便地定位代码中的问题，从而进行调试和错误修复。

10. 观察变量

在调试过程中，我们可以通过在VS Code的侧边栏中选择”变量（Variables）”面板，来查看当前变量的值。当程序暂停执行时，我们可以看到每个变量的值和类型，并可以通过展开和折叠变量来查看更多细节。

通过观察变量的值，我们可以更容易地理解程序的状态，并找到潜在的错误或问题所在。

11. 调试控制

在调试过程中，我们还可以使用调试控制面板来控制程序的执行。调试控制面板位于VS Code的底部，包含了一些常用的调试按钮。

通过调试控制面板，我们可以点击”继续（Continue）”按钮来继续执行代码，或点击”停止（Stop）”按钮来停止调试。还可以使用”重新开始（Restart）”按钮来重新启动调试会话。

12. 调试配置修改

在实际开发中，我们可能需要修改调试配置，例如切换到不同的Python解释器、指定不同的程序入口等。

要修改调试配置，我们可以打开”launch.json”文件，修改”configurations”数组中的配置项。可以根据自己的需要，添加或修改以下配置项：

• "pythonPath": 指定Python解释器的路径，例如"pythonPath": "/usr/bin/python3"；
• "program": 指定要调试的Python文件，例如"program": "${workspaceFolder}/main.py"；
• "args": 指定运行时的参数，例如"args": ["arg1", "arg2"]；
• "env": 指定运行时的环境变量，例如"env": {"DEBUG": "True"}。

13. 结束语

通过使用VS Code的调试功能，我们可以更轻松地进行Python代码的调试和错误排查。本文介绍了基本的安装配置步骤，并提供了调试的使用方法。