vscode如何调试python:两种主流方案
vscode如何调试python,优先安装Python扩展,选择解释器后用launch.json配置调试,也可以直接使用代码行左侧的运行和调试按钮快速启动,launch.json适合断点、传参、多文件项目调试,行内调试适合短脚本、单文件快速排查;该方法的适用边界是本地已经装好Python环境,没有虚拟环境路径错乱、扩展版本严重滞后的情况,在线网页版VSCode、容器内无权限环境下,部分调试功能会受限。
vscode调试python前置准备
打开扩展面板,搜索Microsoft发布的Python扩展完成安装,安装完成后重启编辑器,按下Ctrl+Shift+P调出命令面板,输入Python:SelectInterpreter,在列表里选中你要使用的Python解释器,包含虚拟环境、conda环境的解释器都在这里选择,选错解释器会出现包导入失败、断点不触发的情况。你可以在终端输入python--version核对当前解释器版本,确认和VSCode选中的版本保持一致。
创建后缀为.py的代码文件,代码必须没有语法错误,语法报错会直接阻断调试启动。你可以先在终端运行一次脚本,确认基础运行逻辑正常,再接入调试流程。
vscode调试python快速行内调试
在代码行号左侧空白处单击,出现红色圆点就是断点,断点标记代表程序运行到这一行时暂停。鼠标悬浮在代码行号旁边,会出现运行和调试的图标,点击图标,选择调试Python文件,程序就会启动,抵达断点位置自动停下。
调试面板出现五个核心操作按钮,分别是继续、单步跳过、单步进入、单步跳出、重启调试。单步进入会进入函数内部代码,单步跳过直接执行当前行,不进入函数,适合不同排查需求。
这个方式上手快,不用写配置文件。
vscode调试python使用launch.json配置调试
点击左侧调试图标,点击创建launch.json文件,选择Python,编辑器自动生成基础配置模板,配置文件存放在项目根目录的.vscode文件夹内。基础配置类型为python,请求类型选launch,program字段填写脚本路径,${file}代表当前打开文件,适合通用调试场景。
你可以在配置里增加args参数,用来给脚本传入命令行参数,增加cwd参数指定程序运行的工作目录,适合读取相对路径文件的项目。如果需要调试模块,把request类型改为attach,附加到正在运行的Python进程上,多用于服务类脚本。
| 调试方式 | 配置文件 | 适合场景 | 限制 |
|---|---|---|---|
| 行内快速调试 | 无需编写 | 单文件短脚本、临时测试 | 自定义参数、工作目录调整不便 |
| launch.json调试 | 需要维护配置 | 多文件项目、传参调试、服务调试 | 配置写错会调试失败 |
调试暂停后,左侧变量面板会展示局部变量、全局变量的值,你可以在调试控制台输入表达式,实时查看变量、执行简单代码,不用修改源文件就能验证猜想。监视面板可以手动添加变量名,持续跟踪目标数值变化,循环逻辑排查时效率更高。
断点不会在注释、空行上生效,你把断点打在空行,程序不会在这里暂停。
遇到断点不命中,先核对解释器是否匹配,再确认代码是不是已经保存,未保存的代码修改不会进入调试进程。
