在 VS Code 中调试 Python 脚本需先安装 Python 扩展并配置解释器,再在可执行行设断点,按 F5 启动调试,用 F10/F11/Shift+F11/F5 控制单步执行,并通过调试面板查看变量、监视表达式和调用栈。

在 VS Code 中用调试器逐行执行 Python 脚本,核心是设置断点 + 启动调试会话,不需要手动按 F10/F11,系统会自动停在断点处,再通过快捷键控制单步执行。
确保 Python 扩展已安装并配置好解释器
VS Code 默认不带 Python 支持。先装好 Python 扩展(由 Microsoft 提供),然后按 Ctrl+Shift+P(Win/Linux)或 Cmd+Shift+P(Mac),输入 Python: Select Interpreter,选中你项目使用的 Python 环境(比如 venv 或 conda 环境)。这一步没做对,调试器根本不会启动。
在代码里加断点,再按 F5 启动调试
点击代码行号左侧的空白区域,出现红点即为断点。建议至少在入口函数(如 if __name__ == "__main__": 下第一行)或关键逻辑前设一个。保存文件后,直接按 F5 —— VS Code 会自动识别 Python 文件,生成临时 .vscode/launch.json(如果还没建的话),然后运行并停在第一个断点。
用快捷键控制逐行执行
停在断点后,就可以用这些常用键推进:
立即学习“Python免费学习笔记(深入)”;
- F10:单步跳过(Step Over)——执行当前行,不进入函数内部
- F11:单步进入(Step Into)——遇到函数调用就跳进去,适合查函数内部逻辑
- Shift+F11:单步跳出(Step Out)——快速执行完当前函数,返回到调用它的地方
- F5:继续运行(Continue)——直到下一个断点或程序结束
善用调试面板看变量和调用栈
调试启动后,左侧会自动展开调试面板。你可以:
- 在 变量(Variables) 区实时查看当前作用域里的所有变量值,鼠标悬停在代码上也能看到值
- 在 监视(Watch) 区手动添加表达式,比如 len(my_list) 或 user.age > 18,方便跟踪复杂判断
- 在 调用栈(Call Stack) 区看清函数调用路径,点击某一层还能直接跳转到对应源码位置
基本上就这些。不复杂但容易忽略的是:断点必须设在可执行行(比如不能设在空行或注释行),且脚本要能正常运行(语法错误会导致调试直接失败)。调通一次,后面排查逻辑问题就快多了。










