VSCode中配置Python调试环境需先安装Python扩展和解释器，通过命令选择解释器路径；设断点后按F5启动调试，支持单步执行、变量查看与调试控制台交互；可定制launch.json实现模块调试、环境变量注入等高级功能。
VSCode中配置Python调试环境
确保已安装Python扩展（Microsoft官方发布）和对应版本的Python解释器。在VSCode中按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入“Python: Select Interpreter”，选择系统中已安装的Python路径（如 python3.11 或虚拟环境中的 venv/bin/python）。这一步决定调试时实际运行的Python版本和包环境。
快速启动调试会话
打开要调试的Python文件（如 main.py），在左侧编辑器边栏点击行号左侧设置断点（红色圆点），或按 F9 切换断点。按 F5 启动调试——若首次运行，VSCode会自动生成 .vscode/launch.json 配置文件，默认使用 Python File 预设，直接运行当前打开的脚本。
- 断点生效后，程序会在该行暂停，变量面板自动显示局部变量、全局变量及表达式求值结果
- 用 F10 单步跳过（Step Over）、F11 单步进入函数（Step Into）、Shift+F11 跳出当前函数（Step Out）
- 调试控制台（Debug Console）支持实时执行Python语句，比如打印
type(my_list)或修改变量值count = 100
定制launch.json实现复杂调试场景
手动编辑 .vscode/launch.json 可适配不同需求。常见配置项包括：
-
module：调试包入口，如
"module": "pytest"配合"args": ["test_sample.py"]直接调试测试 -
env：注入环境变量，例如
"env": {"DEBUG": "1", "PYTHONPATH": "${workspaceFolder}/src"} -
justMyCode：设为
false可进入标准库或第三方包源码（需有对应.py文件） -
console：设为
"integratedTerminal"让程序输入输出走终端，适合需要用户交互的脚本
高效排查常见问题
调试时遇到“ModuleNotFoundError”通常因解释器路径或工作目录不对；可在 launch.json 中显式指定 "cwd": "${workspaceFolder}/src"。断点未命中？检查是否启用了 justMyCode（默认开启）、文件是否被优化编译（如 .pyc 运行）、或代码实际执行路径与预期不符。对于异步代码，启用 "subProcess": true 可捕获子进程中的断点。
立即学习“Python免费学习笔记（深入）”；
调试不是只看变量，关键是理解控制流如何到达某一行——多用“调用堆栈”面板回溯函数链，比盲目加print更省时间。
