需安装Python扩展、配置解释器、创建launch.json、设断点并启动调试、验证响应能力，五步完成VSCode Python调试环境搭建。
一、安装Python扩展
VSCode本身不内置Python调试支持，需通过官方Python扩展启用调试功能。该扩展提供调试器集成、断点管理、变量查看等核心能力。
1、打开VSCode，点击左侧活动栏的扩展图标（或按 Ctrl+Shift+X）。
2、在搜索框中输入 Python，找到由 Microsoft 发布的官方扩展（ID：ms-python.python）。
3、点击“安装”按钮，等待安装完成并重启VSCode（如提示）。
立即学习“Python免费学习笔记（深入）”；
二、确认Python解释器路径
调试器必须指向一个有效的Python可执行文件，否则无法启动调试进程。VSCode需明确知道使用哪个Python版本及其位置。
1、按下 Ctrl+Shift+P 打开命令面板，输入并选择 Python: Select Interpreter。
2、在弹出列表中选择已安装的Python解释器，例如 Python 3.11.9 ('venv': venv) 或系统全局路径如 /usr/bin/python3。
3、确认状态栏右下角显示所选解释器路径，且无红色警告图标。
三、创建launch.json调试配置
VSCode通过 .vscode/launch.json 文件定义调试行为，包括启动方式、参数、工作目录等。该文件是调试会话的唯一配置入口。
1、确保项目根目录已打开（File → Open Folder），而非仅打开单个.py文件。
2、按下 Ctrl+Shift+D 切换到运行视图，点击顶部的“创建 launch.json 文件”链接。
3、在环境选择菜单中，选择 Python File 预设模板。
4、VSCode自动生成 .vscode/launch.json，其中包含类似以下内容的配置项：
{"name": "Python File", "type": "python", "request": "launch", "module": "none", "justMyCode": true}
四、设置断点并启动调试
断点是调试的核心交互点，只有在有效配置下才能被调试器识别并暂停执行。
1、在Python源文件中，点击行号左侧灰色区域，出现实心红点即表示断点已设置成功。
2、确保当前打开的文件为调试目标（如 main.py），且该文件路径可被所选解释器直接执行。
3、按下 F5 启动调试，或点击运行视图中的绿色三角形按钮；若弹出环境选择提示，确认已选中正确的Python解释器。
4、程序将在第一个断点处暂停，此时可查看变量值、调用堆栈及调试控制台输出。
五、验证调试器响应能力
调试器是否正常响应，可通过观察调试工具栏与变量面板的实时更新来判断。任何静态或无响应现象均表明底层通信链路存在问题。
1、在调试暂停状态下，将鼠标悬停于任意变量名上，应立即显示其当前值和类型。
2、在调试控制台（位于调试视图底部）中输入 print("test") 并回车，应输出结果且无语法错误提示。
3、点击调试工具栏中的“继续”（F5）、“单步跳过”（F10）、“单步进入”（F11）按钮，程序执行流应随之准确响应。
