在 VS Code 中调试 Python 脚本需安装 Python 扩展并选择正确解释器,于可执行语句左侧设断点,再通过 Ctrl+F5、调试图标或右键“Debug Python File”启动;支持单步跳过(F10)、进入(F11)、跳出(Shift+F11)及继续运行(F5)等操作。

在 VS Code 中调试 Python 脚本,核心是配置好 Python 扩展、选择正确的解释器,并在代码行号左侧点击设置断点,然后启动调试会话。
确保已安装必要组件
先确认已安装 Python 扩展(由 Microsoft 提供) 和一个可用的 Python 解释器(如 Python 3.9+)。可在扩展市场搜索 “Python”,安装后重启 VS Code。打开命令面板(Ctrl+Shift+P 或 Cmd+Shift+P),输入 “Python: Select Interpreter” 并选择你项目使用的 Python 环境(如虚拟环境中的 python.exe 或 python3)。
在代码中设置断点
打开要调试的 .py 文件,在想暂停执行的某一行左侧的空白区域单击——会出现一个红色圆点,即断点。可设多个断点。注意:断点必须打在可执行语句上(比如不能打在空行、纯注释或函数定义的 def 行上,但可以打在函数内部第一行有效代码处)。
启动调试会话
有三种常用方式:
立即学习“Python免费学习笔记(深入)”;
- 按 Ctrl+F5(Windows/Linux)或 Cmd+F5(macOS)直接运行当前文件(无需配置 launch.json)
- 点击左侧活动栏的调试图标(虫子图标),再点顶部绿色 ▶️ 按钮(需先确保已生成或存在 .vscode/launch.json)
- 右键编辑器内任意位置 → 选择 “Debug Python File”
启动后程序会在第一个断点暂停,此时可查看变量值、调用栈、在 Debug Console 中执行表达式。
常用调试操作
调试工具栏出现在顶部(或按 Ctrl+Shift+Y 打开调试面板):
- F10:单步跳过(Step Over),执行当前行,不进入函数内部
- F11:单步进入(Step Into),进入当前行调用的函数
- Shift+F11:单步跳出(Step Out),执行完当前函数并返回上层
- F5:继续运行到下一个断点
- 点击断点红点可临时禁用/启用它;右键断点可设置条件断点或日志点
基本上就这些。不需要复杂配置也能快速开始,但遇到多文件、参数传入或 Flask/Django 等框架时,建议补充 launch.json 配置。










