Python调试效率取决于理解pdb触发机制、breakpoint()行为差异及IDE与debugpy的脱节点；breakpoint()受PYTHONBREAKPOINT环境变量控制，n/s命令在生成器和装饰器中行为异常，debugpy需注意端口绑定与子进程继承，日志与断点混合使用时存在输出时机和副作用问题。
pdb 的触发机制、breakpoint() 的行为差异、以及 IDE 调试器与底层调试协议（如 debugpy）之间的脱节点。
为什么 breakpoint() 有时不生效？
Python 3.7+ 引入的 breakpoint() 并非硬编码调用 pdb，而是读取环境变量 PYTHONBREAKPOINT 决定执行哪个可调用对象。默认值是 pdb.set_trace，但一旦被修改（比如设为 0 或空字符串），就会静默跳过。
- 检查是否被禁用：
echo $PYTHONBREAKPOINT
- 临时启用：
PYTHONBREAKPOINT=pdb.set_trace python script.py
- 在代码中覆盖：
import os
os.environ["PYTHONBREAKPOINT"] = "pdb.set_trace" - 注意：某些 IDE（如 PyCharm）会自动设置该变量为自研调试入口，此时
breakpoint()实际走的是 IDE 协议，而非终端pdb
pdb 中 n 和 s 的关键区别在哪？
这不是操作习惯问题，而是作用域控制逻辑的根本差异：n（next）跳过函数调用，s（step）进入函数体。但很多人忽略的是——n 对生成器、异步协程、装饰器包裹的函数行为异常。
-
n在遇到yield或await时，会直接跳到下一行，不进入生成器/协程内部 - 装饰器（如
@lru_cache）可能让n表现为“跳过整个逻辑”，因为实际执行的是缓存代理函数 - 推荐组合：
s进入可疑函数 →l查看当前上下文 →p var_name检查变量值
VS Code 调试器连不上 debugpy？先确认端口和子进程
VS Code 默认通过 debugpy 启动调试会话，但常见失败不是配置错，而是进程模型没对齐：
- 主进程启动
debugpy监听端口（如5678），但子进程（multiprocessing、subprocess）默认不继承调试状态 - 若用
launch.json配置"console": "integratedTerminal"，需确保终端未被其他 Python 进程占用 - 远程调试时，
debugpy.listen()必须显式绑定0.0.0.0:5678，不能只写127.0.0.1（Docker 容器内尤其容易卡在这里） - 验证监听状态：
ss -tuln | grep 5678
或lsof -i :5678
日志 + 断点混合调试时最容易漏掉什么？
一边打 logging.debug("value=%r", x)，一边在附近加 breakpoint()，看似稳妥，实则存在时间差和副作用干扰：
立即学习“Python免费学习笔记（深入）”；
-
logging的debug级别默认不输出，需提前配置logging.basicConfig(level=logging.DEBUG) -
breakpoint()会暂停，但日志可能已刷入缓冲区未显示（尤其重定向到文件时），造成“断点处变量和日志对不上”的错觉 - 更隐蔽的问题：某些对象（如
threading.Lock、generator）在pdb中调用pp或p可能触发状态变更，导致程序行为偏移
breakpoint() 去哪，pdb 命令语义决定停在哪，IDE 配置决定能否连上，而日志输出时机和对象副作用决定你看到的是否是真实现场。 
