F5无反应是因未安装或启用Microsoft官方Python扩展，装后须重启VSCode；launch.json配置错误、断点设在不可执行行、Web框架重载未关闭等均会导致调试失败。
点开Python文件后按F5没反应？先确认调试器已安装
VSCode本身不自带Python调试能力，必须装好ms-python.python扩展（旧版叫ms-python.pylance不算数）。如果按F5弹出“没有配置启动项”，不是你操作错了，是插件根本没装或被禁用。打开扩展面板搜“Python”，认准发布者是Microsoft、名字带Python且状态为“已启用”的那个。
- 检查方法：按
Ctrl+Shift+X（Win/Linux）或Cmd+Shift+X（Mac），输入python，看是否有Python扩展显示“启用中” - 如果只装了
Pylance，它只负责代码补全和类型检查，不提供调试功能 - 装完扩展后必须重启VSCode，否则
F5仍无效
.vscode/launch.json配错导致断点失效
断点变成空心圆、鼠标悬停提示“断点未命中”，大概率是launch.json里module或program路径写错了。VSCode调试Python有两种主流模式：module（如python -m http.server）和program（直接运行脚本），二者不能混用。
- 用
module方式调试时，module字段填模块名，不是文件路径，例如调试myproject/main.py且该文件在sys.path里，就写"module": "main"，别写"main.py" - 用
program方式时，program必须是相对工作区根目录的路径，比如工作区打开的是/home/user/myproject，脚本在src/app.py，就得写"program": "src/app.py"，不能写绝对路径或./src/app.py - 如果项目用了虚拟环境，务必在
launch.json里指定python解释器路径，或先在VSCode底部状态栏选对解释器（点击Python版本号）
断点不触发？检查是否在可执行行上设了断点
Python调试器只在能执行的语句行生效。在注释、空行、函数定义首行（def foo():这行）、类定义行（class A:）设断点，VSCode会自动把它挪到下一行可执行代码，但有时会挪错位置，尤其遇到装饰器或多行表达式时。
- 常见陷阱：在
@decorator下面那行def设断点 → 实际停在函数体第一行；在if x:设断点 → 停在if块内第一条语句 - 更稳妥的做法：把断点设在变量赋值、函数调用、
print()这些明确有副作用的语句上 - 如果断点始终灰色，右键点击断点 → “编辑断点”，检查是否误加了条件或命中次数限制
调试Flask/FastAPI等Web服务时卡在启动阶段
这类框架默认开启重载（reloader）和多进程，VSCode调试器无法 attach 到子进程，导致app.run()之后就失去控制，或者反复重启看不到断点。
- 必须关掉重载：Flask加
debug=False, use_reloader=False；FastAPI用uvicorn.run(..., reload=False) - 不要直接运行
python app.py，改用python -m uvicorn app:app这类模块方式，并在launch.json中用module模式配置 - 如果用
gunicorn，它天生不支持单步调试，得切回uvicorn或flask run临时调试
调试器能停住不代表逻辑就对了——比如异步代码里在await前设断点，看起来停了，但事件循环可能已经推进了一大截。真要抠细节，得配合logging打时间戳，或者用asyncio.debug = True。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
