VSCode Python调试需同时满足三条件：安装并启用Microsoft的ms-python.python扩展、正确选择Python解释器、精准配置launch.json；否则F5无响应、断点无效或程序跑完才停。
F5没反应、断点不生效、程序跑完才停——不是代码有问题，是调试环境没搭对。必须装对扩展、选对解释器、配对 launch.json，三者缺一不可。
VSCode 按 F5 没反应？先确认 Python 扩展已启用
VSCode 本身不带 Python 调试能力，ms-python.python 扩展（发布者 Microsoft）是唯一能提供完整调试支持的组件。只装 ms-python.pylance 不行，它只管补全和类型检查。
检查方法：Ctrl+Shift+X（Win/Linux）或 Cmd+Shift+X（Mac），搜 “Python”，认准状态为“已启用”且发布者是 Microsoft 的那一项。装完必须重启 VSCode，否则 F5 依然无效。
常见错误现象：
- 按 F5 弹出“没有配置启动项” → 扩展根本没装或被禁用
- 底部状态栏显示“未选择解释器” → 即使扩展装了，也进不了调试流程
launch.json 配错，断点就成摆设
VSCode 全靠 launch.json 知道怎么启动 Python 进程。默认模板生成的配置看似能用，但稍有偏差就会导致断点灰色、ModuleNotFoundError 或直接跳过断点。
关键字段差异：
- 用
"program": "${file}"：调试当前打开的单个文件，适合脚本式入口（如if __name__ == "__main__"） - 用
"module": "mypackage.main"：等价于python -m mypackage.main，模块名不能带.py，也不能写路径 - 传参必须用
"args"字段，比如"args": ["--url", "https://example.com"]，不能塞进program字符串里 - 工作目录常被忽略：
"cwd": "${workspaceFolder}/src"要显式指定，否则import utils或读取config.yaml会失败
调试 Web 服务（Flask/FastAPI）时，"justMyCode": true 默认会过滤掉框架启动逻辑，可临时设为 false 排查，但别长期开着——你会卡在 site-packages 里出不来。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
断点设在哪才真正生效？
断点图标变实心红点 ≠ 程序会在那停。Python 调试器只响应可执行语句，很多地方看着能设，其实无效。
容易踩的坑：
- 在
@decorator行或def foo():那行设断点 → 实际停在函数体第一行，但有时会偏移 - 在
if x:或for item in lst:这类控制流关键字行设断点 → 停在块内第一条语句，不是条件判断本身 - 在注释、空行、类定义首行（
class A:）设断点 → 断点自动下移，但多行装饰器或复杂表达式下可能挪错
更稳妥的做法：把断点设在变量赋值（data = requests.get(...)）、函数调用（parse(data)）、print() 这类明确有副作用的语句上。右键断点 → “编辑断点”，检查是否误加了条件或命中次数限制。
Web 框架/异步/子进程调试失效？不是断点问题，是调试器没 attach 上
Flask 默认开启 use_reloader=True，FastAPI 用 Uvicorn 多进程，aiohttp 启动事件循环——这些都会 fork 出新进程，而 VSCode 默认只 attach 主进程。
解决方向：
- Flask：启动时加
debug=False, use_reloader=False，或改用python -m flask run --no-reload，对应launch.json里用"module": "flask"+"args": ["run", "--no-reload"] - 异步代码：确保
"console": "integratedTerminal"，否则事件循环可能被阻塞；必要时加"subProcess": true尝试捕获子进程（效果有限） - 子进程（
subprocess.Popen/multiprocessing.Process）：VSCode 原生不支持跨进程调试，得靠日志或改用debugpy手动 attach 到子进程 PID
最常被忽略的一点：console 字段没设或设成 internalConsole，会导致 input() 卡住、HTTP 请求无响应、甚至整个调试会话静默退出。只要脚本需要终端交互或输出进度条，就必须用 "console": "integratedTerminal"。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
