Python调试器内部实现：如何用sys.monitoring API实现断点暂停及Bdb原理

Bdb实现断点暂停的核心逻辑 #

• Bdb本质是基于Python的跟踪钩子和帧对象实现的，核心依赖sys.settrace()或sys.setprofile()注册全局跟踪函数——这个函数会在代码执行的关键节点（如函数调用、行切换）被触发。
• 当你用Bdb设置断点时，它会把断点的文件名、行号等信息存入内部列表。每次跟踪函数被调用，就会检查当前执行帧的位置是否匹配已注册的断点。
• 一旦命中断点，Bdb会调用interaction()方法启动交互调试循环：此时脚本的执行流被挂起，调试器接管终端输入输出，等待你输入c（继续）、n（下一步）等命令，直到你发出恢复执行的指令，才会退出循环让脚本继续运行。

实现断点暂停可用的sys模块工具 #

对于Python 3.12+，你可以结合以下两种方式实现：

1. 传统的sys.settrace() #

这是Bdb的核心依赖，你可以在自定义断点钩子中临时注册跟踪函数，或者直接在断点触发时启动交互循环。

2. 新的sys.monitoring API #

• 用sys.monitoring.register()注册BREAKPOINT或LINE事件的回调函数，当断点触发时，回调会被调用。
• 在回调中，你可以通过inspect.currentframe()获取当前执行帧，然后启动自定义的交互循环，控制脚本的暂停与继续。

极简自定义断点暂停实现示例 #

import sys
import inspect

def custom_breakpointhook():
    # 获取触发断点的上层帧（跳过当前hook本身的帧）
    frame = inspect.currentframe().f_back
    print(f"断点触发于 {frame.f_code.co_filename}:{frame.f_lineno}")
    
    # 交互调试循环
    while True:
        cmd = input("(mydebug) ").strip()
        if cmd == 'c':
            break  # 退出循环，恢复脚本执行
        elif cmd.startswith('p '):
            # 打印变量，利用帧的全局/局部命名空间
            var_name = cmd.split(maxsplit=1)[1]
            try:
                value = eval(var_name, frame.f_globals, frame.f_locals)
                print(f"{var_name} = {repr(value)}")
            except Exception as e:
                print(f"错误: {str(e)}")
        elif cmd == 'q':
            sys.exit(0)
        else:
            print("支持命令: c(继续), p <变量名>(打印), q(退出)")

# 替换默认的breakpointhook
sys.breakpointhook = custom_breakpointhook

# 测试代码
print("断点前的代码")
breakpoint()
print("断点后的代码")

内容的提问来源于stack exchange，提问作者ACBlue