VSCode Python调试配置完整指南

首先确认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免费学习笔记（深入）”；

操作步骤：

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

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

常用字段说明：

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

应对常见调试场景

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

白瓜面试

白瓜面试 - AI面试助手,辅助笔试面试神器

40

查看详情

调试带参数的脚本

指定工作目录和环境变量

调试 Django 项目

调试 Flask 应用

调试技巧与注意事项

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

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

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

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

以上就是VSCode Python调试配置完整指南的详细内容，更多请关注php中文网其它相关文章！