安装Python扩展并配置launch.json文件后,即可在VSCode中设置断点、查看变量、逐步执行代码,实现流畅调试。

在VSCode中调试Python代码非常方便,只要配置正确,可以轻松设置断点、查看变量、逐步执行代码。关键是安装必要的扩展并正确设置调试配置文件。
安装Python扩展
确保已安装VSCode官方的Python扩展,这是支持Python调试的基础。
- 打开VSCode,进入左侧“扩展”面板(Ctrl+Shift+X)
- 搜索“Python”,由Microsoft发布,点击安装
- 安装后会自动支持语法高亮、智能提示和调试功能
配置调试环境
VSCode使用launch.json文件来定义调试配置。首次调试时会引导你创建它。
- 打开要调试的Python文件
- 点击左侧“运行”图标(或按Ctrl+Shift+D)
- 点击“创建一个launch.json文件”
- 选择“Python”环境
- 选择“当前文件”作为默认配置
生成的配置大致如下:
立即学习“Python免费学习笔记(深入)”;
免费 盛世企业网站管理系统(SnSee)系统完全免费使用,无任何功能模块使用限制,在使用过程中如遇到相关问题可以去官方论坛参与讨论。开源 系统Web代码完全开源,在您使用过程中可以根据自已实际情况加以调整或修改,完全可以满足您的需求。强大且灵活 独创的多语言功能,可以直接在后台自由设定语言版本,其语言版本不限数量,可根据自已需要进行任意设置;系统各模块可在后台自由设置及开启;强大且适用的后台管理支
{
"version": "0.2.0",
"configurations": [
{
"name": "Python: 当前文件",
"type": "python",
"request": "launch",
"program": "${file}",
"console": "integratedTerminal"
}
]
}
这个配置表示:调试时运行当前打开的文件,并在集成终端中显示输出。
开始调试
配置完成后,就可以开始调试了。
- 在代码行号左侧点击,设置红色圆点断点
- 按下F5,或点击“运行”侧边栏中的“运行和调试”按钮
- 程序会在断点处暂停,此时可以查看变量值、调用堆栈等信息
- 使用顶部的调试工具条进行单步执行(Step Over)、步入(Step Into)、跳出(Step Out)等操作
常见问题处理
如果调试无法启动,检查以下几点:
- 确认Python解释器已正确选择(底部状态栏显示当前解释器,可点击切换)
- 确保launch.json中的"console"设为"integratedTerminal",否则输入可能无法响应
- 若使用虚拟环境,确保python.pythonPath指向正确的解释器路径(新版用python.defaultInterpreterPath)
基本上就这些。只要环境配好,VSCode的Python调试体验很流畅,适合日常开发和问题排查。









