vscode 配置调试 python 只需三步:安装官方 Python 扩展、选择正确解释器、配置 launch.json;支持断点、变量查看、单步执行等完整调试功能。

在 VSCode 中配置和调试 Python 代码其实不复杂,关键是装对扩展、选对解释器、配好启动项。只要三步到位,断点、变量查看、单步执行都能顺滑运行。
安装 Python 扩展和依赖
打开 VSCode 的扩展市场(Ctrl+Shift+X),搜索并安装官方 Python 扩展(由 microsoft 提供)。它自带 Pylance(智能补全)、调试器、测试支持等功能。不需要额外装 Debugger for Python 等插件。
确保系统已安装 Python(推荐 3.8+),并在终端中能运行 python –version 或 python3 –version。VSCode 启动后会自动检测已安装的 Python 解释器,若没识别到,可手动添加路径(Ctrl+Shift+P → “Python: select Interpreter”)。
配置 launch.json 调试设置
在项目根目录下创建 .vscode/launch.json(可通过运行调试面板右上角齿轮图标自动生成)。常用配置如下:
立即学习“Python免费学习笔记(深入)”;
1、演示:以截图为准 程序试用后台:http://你的域名/admin/login.asp 后台登陆帐号:admin 密码:admin 说明: 这个是基于asp+access的企业网站源码,数据库已设有有防下载,网站更安全 要修改网站,自定义你自己要的页面,和美化页面都是你自己完成,网站源码程序完整,后台功能强大。 调试运行环境:要安装IIS服务器(IIS的安装和配置,安装好后,在地址栏输入:h
0 - 调试当前文件:用 “module”: “python” 或直接 “program”: “${file}”
- 带参数运行:在 “args” 字段加数组,比如 [“–input”, “data.txt”]
- 工作目录指定:用 “cwd”: “${workspaceFolder}/src” 避免路径错误
- 启用 flask/Django 等框架热重载:加 “env”: {“FLASK_ENV”: “development”}
开始调试与常用技巧
在代码行号左侧点击设断点(红点),按 F5 启动调试。调试时可:
- 鼠标悬停变量查看值,或在“变量”面板展开查看作用域
- F10 单步跳过,F11 单步进入函数,Shift+F11 跳出
- 在“调试控制台”中直接执行表达式(如 len(my_list)),支持修改变量
- 右键断点可设“条件断点”(比如 x > 100)或“日志点”(不中断,只输出)
常见问题快速排查
如果按 F5 没反应或报错:
- 检查左下角状态栏是否显示正确的 Python 解释器路径(点击可切换)
- 确认 launch.json 中的 program 路径存在且是 .py 文件
- 终端报 ModuleNotFoundError?多半是解释器环境没装对应包,用该解释器的 pip 安装(如 python -m pip install requests)
- 中文路径或文件名导致异常?尽量把项目放在纯英文路径下
基本上就这些。配一次,后续项目复制 .vscode 文件夹就能复用。调试体验接近 pycharm,又保有 VSCode 的轻快和灵活。