VSCode调试Python需正确配置Python扩展、解释器路径和launch.json。安装ms-python.python扩展，通过命令选择项目对应解释器，VSCode自动记录路径；单文件调试可点击右上角▶️运行，复杂场景需配置launch.json，设置module、args、env等字段，并掌握F5/F9/F10/F11等调试快捷键。
在 VSCode 中调试 Python 代码，核心是配对好 Python 扩展、正确的解释器路径 和 可运行的调试配置。不装插件、不选解释器、乱写 launch.json，十有八九会卡在“找不到模块”或“启动失败”上。
装对扩展，选对解释器
确保已安装官方 Python 扩展（ms-python.python），它自带调试器（ptvsd 已弃用，现在用 debugpy）。安装后按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（Mac），输入 Python: Select Interpreter，从列表中选你项目实际使用的 Python 环境（如 venv、conda 或系统 Python）。VSCode 会在工作区根目录下生成 .vscode/settings.json 记录该路径，这是调试能识别包和依赖的前提。
用图形界面快速启动调试
不用手动写配置也能调试：打开你要调试的 .py 文件，确保光标在代码内（比如某一行函数里），点击编辑器右上角的 ▶️ Run and Debug（运行和调试）图标，再点 Run Python File in Terminal。这会自动以当前文件为入口、用已选解释器执行，并支持断点——适合单文件脚本或快速验证逻辑。
需要自定义？写一个干净的 launch.json
当要传命令行参数、调试 Flask/Django、或附加到进程时，就得手动配 .vscode/launch.json。推荐用 VSCode 自动生成功能：进入 Run → Add Configuration… → Python → Python File，它会生成基础模板。关键字段说明：
立即学习“Python免费学习笔记（深入）”；
-
“module”：调试第三方模块（如
python -m http.server），填"module": "http.server" -
“args”：传参，如
"args": ["8000", "--bind-all"] -
“env”：设环境变量，如
"env": {"FLASK_ENV": "development"} - “justMyCode”: true（默认）：跳过标准库和第三方库的断点，专注自己的代码
断点与调试操作别忽略细节
打断点只需点击行号左侧空白处，出现红点即生效；但注意：断点必须打在可执行语句上（比如不能打在空行、注释行或函数定义首行）。调试时常用操作：
- F9：切换断点
- F5：启动/继续
- F10：单步跳过（Step Over）
- F11：单步进入（Step Into）
- Shift+F11：单步跳出（Step Out）
- 调试侧边栏可实时看变量值、调用栈、断点列表，鼠标悬停在变量上也能直接看值
基本上就这些。不复杂，但容易忽略解释器和 launch.json 的联动关系。
