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（可通过运行调试面板右上角齿轮图标自动生成）。常用配置如下：
librosa Python 音频与音乐分析库
下载
librosa 是一个用于音频和音乐分析的 Python 库。它提供了特征提取、频谱分析、节拍跟踪、起始检测和音频可视化的工具，基于 NumPy 和 SciPy 构建，用于科学音频计算。
立即学习“Python免费学习笔记（深入）”；
- 调试当前文件：用 "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 的轻快和灵活。
