首先确认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”
生成的默认配置示例如下：
{ “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，即可快速进入断点调试流程。