让你的开发效率提升 300%！掌握 VSCode 调试 Python 代码的终极指南！

最新推荐文章于 2026-01-21 09:26:26 发布

原创最新推荐文章于 2026-01-21 09:26:26 发布 · 1.2k 阅读

16 ·

本内容遵循CC 4.0 BY-SA版权协议

标签

#vscode #python #ide

Python数据挖掘分析专栏收录该内容

87 篇文章

订阅专栏

前言：为什么你需要专业的调试工具？

还在用 print 大法调试 Python 代码吗？作为一名 Python 开发者，掌握专业的调试技能会让你事半功倍！Visual Studio Code (VSCode) 作为当下最流行的代码编辑器之一，其强大的调试功能可以让你像外科医生一样精准定位代码问题。本文将带你从零开始，全面掌握 VSCode 中调试 Python 程序的各项技巧，让你的开发效率提升 300%！

1. 配置 Python 调试环境

在开始调试前，确保你的开发环境准备就绪是成功的第一步。VSCode 的 Python 扩展提供了开箱即用的调试支持，但一些关键配置能让体验更上一层楼。

首先，你需要安装 Python 扩展。在 VSCode 的扩展市场中搜索 "Python"，点击进行安装。这个扩展不仅提供语法高亮和代码补全，更重要的是集成了强大的调试功能。

2. 启动基础调试会话

调试的核心在于控制程序执行流程并观察程序状态。VSCode 提供了多种启动调试的方式，每种都适合不同的场景。

最常用的方法是使用调试启动配置。按下 F5 或点击运行菜单中的 "Start Debugging"，VSCode 会自动为你创建一个基础的 launch.json 配置文件。这个文件定义了调试会话的各种参数。

{
  "version": "0.2.0",    // 配置文件版本号
  "configurations": [
    {
      "name": "Python Debugger: Current File", // 配置名称
      "type": "debugpy",                       // 调试器类型：必须为 debugpy（Python官方调试器）
      "request": "launch",                     // 请求类型
      "program": "${file}",                    // 要调试的Python文件路径，${file} 是VSCode变量，表示当前活动编辑器中的文件
      "console": "integratedTerminal"          // 控制台类型
    }
  ]
}

对应的调试页面如下所示：包括工具栏、变量区域、代码区域、结果输出区域。

3. 调试控制与变量检查

一旦程序在断点处暂停，你就拥有了完全的控制权。VSCode 提供了多种控制执行流程的方式，以及观察变量状态的工具。

这时候大家就会使用工具栏中的工具（以下按从左到右进行介绍）

1、Continue (F5)：恢复程序执行，直到遇到下一个断点或程序结束。

2、Step Over (F10)：执行当前行代码（如果是函数调用，不会进入函数内部，直接得到结果）。

3、Step Into (F11)：进入当前行调用的函数内部进行逐行调试（深入函数实现细节）。

4、Step Out (Shift+F11)：快速执行完当前函数剩余代码，并返回到调用该函数的位置。

5、Restart (Ctrl+Shift+F5)：重新启动调试会话（保持所有断点），比手动停止再启动更高效。

6、Stop (Shift+F5)：强制终止当前调试会话，结束程序运行。

我们可以根据实际情况逐行调试程序代码，然后对应观察变量区域中所有变量及其值的变化情况，如下所示：

4. 调试控制台与表达式求值

VSCode 的调试控制台是一个强大的交互式工具，允许你在程序暂停时执行任意 Python 代码。这比单纯的变量观察要灵活得多。

在调试控制台中，你可以修改变量值、调用函数、测试表达式，甚至定义新函数。这对于快速验证假设或修复简单问题非常有用。

下面我们将展示如何在程序执行过程中实时观察和修改变量，体验交互式调试的真正威力。

5. 断点的高级使用技巧

断点是调试的基石，但很多人只停留在基础的点断点上；VSCode 支持多种高级断点，能极大提升调试效率，普通断点就像撒网捕鱼，而高级断点则是精准的鱼枪。

条件断点允许你设置一个表达式，只有当表达式为真时才会中断。这在循环或频繁调用的函数中特别有用。右键点击断点红点，选择 "Edit Breakpoint" 即可添加条件。

如下例子所示

def process_items(items):
    """处理混合类型数据，记录处理日志"""
    results = []
    for index, item in enumerate(items):
        # 这里将设置条件断点
        processed = str(item).upper()
        results.append(f"{index}:{processed}")
        print(f"已处理: {item} -> {processed}")
    return results

# 测试数据 - 故意混合多种类型
test_data = [
    100,            # 整数
    "hello",        # 字符串
    3.14,           # 浮点数
    True,           # 布尔值
    {"key": "value"},  # 字典
    [1, 2, 3],      # 列表
    None            # 空值
]

if __name__ == "__main__":
    print("处理结果:", process_items(test_data))

我们通过以下步骤设置条件断点

基础条件断点：在 processed = str(item).upper() 这行左侧装订线点击添加断点
右键断点红点 → 选择 "Edit Breakpoint" → 选择 "Expression"
输入条件表达式：isinstance(item, str)

现在运行调试(F5)，你会发现程序只会在遇到字符串元素时暂停，如下所示，当遇到 item 为 hello 时，进入调试状态。

6. 远程调试与复杂配置

对于大型项目或特殊环境，你可能需要更复杂的调试配置。VSCode 支持远程调试、附加到运行中的进程，以及多进程调试。

下面是一个远程调试的配置示例，允许你连接到远程服务器上的 Python 进程。这在 Docker 容器或云服务器环境中特别有用。

{
  "name": "Python: Remote Attach",
  "type": "python",
  "request": "attach",
  "port": 5678,
  "host": "localhost",
  "pathMappings": [
    {
      "localRoot": "${workspaceFolder}",
      "remoteRoot": "/remote/path/to/project"
    }
  ]
}