VS Code Recipes：Python调试完全指南

钱溪双Bridget

于 2025-06-07 09:06:05 发布

阅读量326

点赞数 3

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00591/article/details/148488585

VS Code Recipes：Python调试完全指南

vscode-recipes 项目地址: https://gitcode.com/gh_mirrors/vs/vscode-recipes

作为开发者，调试是我们日常工作中不可或缺的一部分。本文将详细介绍如何在VS Code中高效调试Python代码，帮助开发者快速定位和解决问题。

环境准备

在开始调试之前，我们需要确保开发环境已经正确配置：

安装最新版本的VS Code编辑器
安装Python扩展（这是VS Code中Python开发的核心扩展）
可选：安装代码检查工具（Linter），如pylint或flake8，可以帮助在编码阶段就发现潜在问题

调试配置详解

VS Code使用launch.json文件来配置调试环境。以下是创建和配置调试环境的详细步骤：

点击左侧活动栏中的调试图标（虫子形状的图标）
点击齿轮图标创建launch.json文件
在弹出的环境选择中，选择"Python"

VS Code会生成一个包含多种调试配置的模板文件，主要包括以下几种常用配置：

基础调试配置

{
    "name": "Python: Current File (Integrated Terminal)",
    "type": "python",
    "request": "launch",
    "program": "${file}",
    "console": "integratedTerminal"
}

name: 配置名称，显示在调试启动选项中
type: 调试器类型，固定为"python"
request: 调试请求类型，"launch"表示启动新进程
program: 要调试的程序，${file}表示当前打开的文件
console: 控制台类型，"integratedTerminal"表示使用VS Code内置终端

高级调试配置

附加到进程调试：适用于已经运行的Python进程

{
    "name": "Python: Attach",
    "type": "python",
    "request": "attach",
    "port": 5678,
    "host": "localhost"
}

模块调试：适用于以模块方式运行的Python程序

{
    "name": "Python: Module",
    "type": "python",
    "request": "launch",
    "module": "your-module-name",
    "console": "integratedTerminal"
}

Web框架调试：
- Django项目调试配置
- Flask项目调试配置

实际调试操作指南

基本调试流程

打开要调试的Python文件
在需要调试的行号左侧点击设置断点（会出现红色圆点）
按下F5或点击绿色播放按钮开始调试
程序会在断点处暂停执行
使用调试控制栏中的按钮控制执行流程：
- 继续(F5)
- 单步跳过(F10)
- 单步进入(F11)
- 单步跳出(Shift+F11)
- 重启(Ctrl+Shift+F5)
- 停止(Shift+F5)