VSCode中配置Python调试环境需先安装Python扩展和解释器,通过命令选择解释器路径;设断点后按F5启动调试,支持单步执行、变量查看与调试控制台交互;可定制launch.json实现模块调试、环境变量注入等高级功能。

VSCode中配置Python调试环境
确保已安装Python扩展(Microsoft官方发布)和对应版本的Python解释器。在VSCode中按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),输入“Python: Select Interpreter”,选择系统中已安装的Python路径(如 python3.11 或虚拟环境中的 venv/bin/python)。这一步决定调试时实际运行的Python版本和包环境。
快速启动调试会话
打开要调试的Python文件(如 main.py),在左侧编辑器边栏点击行号左侧设置断点(红色圆点),或按 F9 切换断点。按 F5 启动调试——若首次运行,VSCode会自动生成 .vscode/launch.json 配置文件,默认使用 Python File 预设,直接运行当前打开的脚本。
- 断点生效后,程序会在该行暂停,变量面板自动显示局部变量、全局变量及表达式求值结果
- 用 F10 单步跳过(Step Over)、F11 单步进入函数(Step Into)、Shift+F11 跳出当前函数(Step Out)
- 调试控制台(Debug Console)支持实时执行Python语句,比如打印
type(my_list)或修改变量值count = 100
定制launch.json实现复杂调试场景
手动编辑 .vscode/launch.json 可适配不同需求。常见配置项包括:
Flash ActionScript3 高级教程 pdf,书籍部分目录: 第一章 高级 碰撞检测 不规则图形的检测碰撞 BitmapData.hitTest用于非位图 大量对象的碰撞检测 实现基于网格的碰撞检测 编写网格代码 测试并调整网格 使用此类 检测不只是为了碰撞 第二章 转向 行为 2D向量(Vector2D)类 机车(Vehicle)类 转向机车(SteeredVehicle)类 寻找行为 避开行为 到达行为
-
module:调试包入口,如
"module": "pytest"配合"args": ["test_sample.py"]直接调试测试 -
env:注入环境变量,例如
"env": {"DEBUG": "1", "PYTHONPATH": "${workspaceFolder}/src"} -
justMyCode:设为
false可进入标准库或第三方包源码(需有对应.py文件) -
console:设为
"integratedTerminal"让程序输入输出走终端,适合需要用户交互的脚本
高效排查常见问题
调试时遇到“ModuleNotFoundError”通常因解释器路径或工作目录不对;可在 launch.json 中显式指定 "cwd": "${workspaceFolder}/src"。断点未命中?检查是否启用了 justMyCode(默认开启)、文件是否被优化编译(如 .pyc 运行)、或代码实际执行路径与预期不符。对于异步代码,启用 "subProcess": true 可捕获子进程中的断点。
立即学习“Python免费学习笔记(深入)”;
调试不是只看变量,关键是理解控制流如何到达某一行——多用“调用堆栈”面板回溯函数链,比盲目加print更省时间。









