VSCode Python调试配置完整指南_网络技术_宿州市腾雀网络科技有限公司

VSCode Python调试配置完整指南

发布时间 - 2025-11-11 00:00:00 点击率：次

首先确认Python解释器和VSCode Python扩展已安装并正确选择解释器，底部状态栏显示版本号；接着创建launch.json文件配置调试参数，如name、type、request、program、console和justMyCode等字段；针对不同场景设置args、cwd、env以支持带参脚本、环境变量及工作目录；可配置Django和Flask专用调试；利用断点、变量悬停、调试控制台执行表达式等技巧提升效率，并注意PYTHONPATH设置与模块导入问题，多配置共存可通过下拉菜单切换，确保无语法错误后按F5启动调试。

调试是开发过程中不可或缺的一环。在使用 VSCode 进行 Python 开发时，合理配置调试环境可以极大提升开发效率。本文将一步步带你完成 VSCode 中 Python 调试的完整配置，涵盖基础设置、launch.json 配置详解、常见场景处理以及实用技巧。

确认基础环境准备就绪

开始调试前，确保以下几项已正确安装和配置：

Python 解释器：系统中已安装 Python，并可通过命令行运行 python 或 python3
VSCode Python 扩展：在扩展市场中安装官方 Microsoft 发布的 "Python" 扩展（ms-python.python）
选择正确的解释器：按下 Ctrl+Shift+P，输入 "Python: Select Interpreter"，选择项目使用的 Python 环境（如虚拟环境中的解释器）

若解释器选择正确，VSCode 底部状态栏会显示当前 Python 版本号。

创建并配置 launch.json 文件

VSCode 使用 .vscode/launch.json 文件定义调试启动配置。首次调试时可自动生成，也可手动创建。

操作步骤：

打开一个 Python 文件
点击左侧“运行”图标（或按 Ctrl+Shift+D）
点击“创建 launch.json 文件” → 选择“Python”

生成的默认配置示例如下：

{ "version": "0.2.0", "configurations": [ { "name": "Python: 当前文件", "type": "python", "request": "launch", "program": "${file}", "console": "integratedTerminal", "justMyCode": true } ] }

常用字段说明：

name：配置名称，出现在调试启动菜单中
type：调试类型，固定为 "python"
request：请求类型，"launch" 表示启动程序，"attach" 用于附加到已运行进程
program：要运行的主文件路径，${file} 表示当前打开的文件
console：控制台类型，建议设为 "integratedTerminal"，以便支持输入
justMyCode：是否仅调试用户代码，设为 false 可进入第三方库代码
args：传递给脚本的命令行参数，格式为字符串数组
cwd：程序运行目录，常设为 ${workspaceFolder}
env：设置环境变量，如数据库连接、密钥等

应对常见调试场景

不同项目结构需要不同的调试配置。以下是几种典型情况的写法：

调试带参数的脚本

{ "name": "Run with args", "type": "python", "request": "launch", "program": "${workspaceFolder}/main.py", "args": ["--input", "data.txt", "--verbose"], "console": "integratedTerminal" }

指定工作目录和环境变量

{ "name": "With env and cwd", "type": "python", "request": "launch", "program": "${workspaceFolder}/src/app.py", "cwd": "${workspaceFolder}", "env": { "API_KEY": "12345", "ENV": "dev" } }

调试 Django 项目

{ "name": "Django Runserver", "type": "python", "request": "launch", "program": "${workspaceFolder}/manage.py", "args": ["runserver"], "django": true, "console": "integratedTerminal" }

调试 Flask 应用

{ "name": "Flask App", "type": "python", "request": "launch", "module": "flask", "env": { "FLASK_APP

": "app.py", "FLASK_ENV": "development" }, "args": ["run", "--no-debugger", "--no-reload"], "console": "integratedTerminal" }

调试技巧与注意事项

掌握一些小技巧能让调试更高效：

在代码中点击行号左侧添加断点，红色圆点表示已设置
使用 print 语句虽简单，但调试器能查看变量作用域、调用栈和表达式值
鼠标悬停在变量上可快速查看其当前值
调试时可在“调试控制台”中执行任意 Python 表达式
若遇到模块导入错误，检查 cwd 和 Python 路径，必要时添加 "env": {"PYTHONPATH": "${workspaceFolder}"} }
多配置可共存，通过顶部下拉菜单切换

如果调试无响应，尝试重启 VSCode 或重装 Python 扩展。确保没有语法错误导致脚本无法加载。

基本上就这些。合理配置后，每次调试只需按 F5，即可快速进入断点调试流程。

# python # vscode # js # json # go # app # 栈 # ai # 环境变量 # microsoft # 虚拟环境 # django

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】

上一篇：Win11蓝屏0x0000007B啥意思_0x0000007

下一篇：如何在 composer.json 中添加自己的 PSR-4

相关栏目网站优化
网络推广
网络技术
AI营销

最新文章 Sublime怎么一键压缩JS代码 Su sublime如何在搜索中使用正则表达式 Sublime如何设置透明窗口效果 Su mysql如何设计商品表结构_mysql css属性背景图不显示怎么办_通过检查路如何使用Golang实现排序_Golan 农历闰月是怎么回事_为合回归年加一月调整塑造《刺客信条》艾吉奥传奇的编剧离开育碧 1英里等于多少公里 1mile和km的换 css grid布局中行和列是如何定义的 PS批量旋转和翻转图片，快速校正图片方向 C# Swagger UI自定义方法 C OPPO手机九宫格和全键盘怎么切换_OP Go语言如何实现用户登录注册_Golan 1节飞行速度多少公里每小时 1节是多少公纸嫁衣8千子树第五章庙门怎么开启庙门 Laravel 多行数据编辑表单中实现逐明日之后如何提升钓鱼等级明日之后提升钓支付宝怎样查年度账单_支付宝年度账单查看 C# 多线程UI更新Dispatcher

上一篇：Win11蓝屏0x0000007B啥意思_0x0000007

下一篇：如何在 composer.json 中添加自己的 PSR-4