デバッガはプログラミング言語の非常に重要な部分です。デバッガは、コード エラー (またはバグ) を診断して修正するために使用されるツールです。これにより、開発者はプログラム中にコードのステータスを段階的に表示および分析できます。これは、開発者がコード エラーを診断して修正し、プログラムの動作を理解し、パフォーマンスを最適化するのに役立ちます。デバッガーは、どのプログラミング言語でも非常に強力なツールであり、開発効率とコードの品質を向上させることができます。
プログラムをデバッグする必要がある場合、最も重要な点は、プログラムを停止すると、プログラムの実行を停止することによってのみ、プログラムの実行を観察できるということです。たとえば、99 の九九をデバッグする必要があるステータス:
def m99():
for i in range(1, 10):
for j in range(1, i + 1):
print(f"{i}x{j}={i*j}", end='\t')
print()
if __name__ == '__main__':
m99() 次に、コマンド python -m pdb pdbusage.py を実行して、上記のプログラムをデバッグします:
(py3.8) ➜ pdb_test git:(master) ✗ python -m pdb pdbusage.py
> /Users/xxxx/Desktop/workdir/dive-into-cpython/code/pdb_test/ pdbusage.py(3 )()
-> def m99():
(Pdb) s
> /Users/xxxx/Desktop/workdir/dive-into-cpython/ code/pdb_test/pdbusage .py(10)()
-> if __name__ == '__main__':
(Pdb) s
> /Users/xxxx/Desktop/workdir /dive-into- cpython/code/pdb_test/pdbusage.py(11)()
-> m99()
(Pdb) s
--Call--
> /Users/ xxxx/Desktop/workdir/dive-into-cpython/code/pdb_test/pdbusage.py(3)m99()
-> def m99():
(Pdb) s
> /Users /xxxx/Desktop/workdir/dive-into-cpython/code/pdb_test/pdbusage.py(4)m99()
-> for i in range(1, 10):
(Pdb) s
> /Users/xxxx/Desktop/workdir/dive-into-cpython/code/pdb_test/pdbusage.py(5)m99()
-> for j in range(1, i 1):
(Pdb) s
> /Users/xxxx/Desktop/workdir/dive-into-cpython/code/pdb_test/pdbusage.py(6)m99()
-> print(f"{ i}x{j}={i*j}", end='\t')
(Pdb) p i
1
(Pdb)
もちろんあなたもそうします。IDE でデバッグできます:
私たちのデバッグ経験によれば、デバッグする最初の最も重要なことは簡単にわかります。プログラムは、ブレークポイントを設定した場所にプログラムが存在する必要があるということです。停止できるようにするには
問題は、上記のプログラムがどのように実行されるかです。プログラムが実行されると停止しますか?
以前の研究によると、Python プログラムの実行は、まず Python コンパイラーによって Python バイトコードにコンパイルされ、次に実行のために Python 仮想マシンに渡される必要があることがわかりました。仮想マシンは上位層の Python プログラムへのインターフェイスを提供するため、プログラムの実行時に、現在どこで実行されているかを知ることができます。この謎のメカニズムは sys モジュールに隠されており、実際、このモジュールは Python インタプリタとの対話に使用するほぼすべてのインターフェイスを担当しています。デバッガを実装するための非常に重要な関数は sys.settrace 関数です。この関数はスレッドの追跡関数を設定します。仮想マシンが関数呼び出しを行ってコード行を実行するとき、またはバイトコードの実行後でも、この関数は関数が実行されます。
Python ソース コード デバッガーを実装するには、システムにトレース機能を設定する必要があります。この関数はスレッド固有です。マルチスレッド デバッグをサポートするには、 settrace() または threading.settrace() を使用して、デバッグ対象のスレッドごとにトレース関数を登録する必要があります。
追跡関数には、frame、event、arg の 3 つのパラメータが必要です。 Frame は現在のスタック フレームです。イベントは文字列です: 'call'、'line'、'return'、'Exception'、'opcode'、'c_call'、または 'c_Exception'。 arg はイベントの種類によって異なります。
トレース関数は、新しいローカル スコープに入るたびに呼び出されます (イベントが「call」に設定されている)。新しいスコープのローカル トレース関数への参照を返す必要があります。このスコープ内で追跡を望まない場合は、None を返します。
トレース関数でエラーが発生した場合、settrace(None) を呼び出した場合と同様に、トレース関数は設定解除されます。
イベントの意味は次のとおりです:
call、関数が呼び出されます (または他のコード ブロックが入力されます)。ローカルトレース関数を呼び出す場合は、argにNoneを指定し、戻り値にローカル関数を指定します。
line では、新しいコード行が実行され、パラメーター arg の値は None です。
return、関数 (または他のコード ブロック) が返ろうとしています。例外によってイベントが発生した場合、ローカル トレース関数が呼び出され、引数値 None が返されます。追跡関数からの戻り値は無視されます。
opcode，解释器即将执行新的字节码指令。执行本地追踪函数，arg为空，返回一个新的本地追踪函数。默认情况下，不会发出每个操作码的事件：必须通过在帧上设置 f_trace_opcodes 为 True 来显式请求。
c_call，一个 c 函数将要被调用。
c_exception，调用 c 函数的时候产生了异常。
我们将在此章节中实现一个简单的调试器，以帮助大家理解调试器的实现原理。调试器的实现代码如下所示，只有短短几十行却可以帮助我们深入去理解调试器的原理，我们先看一下实现的效果在后文当中再去分析具体的实现：
import sys
file = sys.argv[1]
with open(file, "r+") as fp:
code = fp.read()
lines = code.split("\n")
def do_line(frame, event, arg):
print("debugging line:", lines[frame.f_lineno - 1])
return debug
def debug(frame, event, arg):
if event == "line":
while True:
_ = input("(Pdb)")
if _ == 'n':
return do_line(frame, event, arg)
elif _.startswith('p'):
_, v = _.split()
v = eval(v, frame.f_globals, frame.f_locals)
print(v)
elif _ == 'q':
sys.exit(0)
return debug
if __name__ == '__main__':
sys.settrace(debug)
exec(code, None, None)
sys.settrace(None)在上面的程序当中使用如下：
输入 n 执行一行代码。
p name 打印变量 name 。
q 退出调试。
现在我们执行上面的程序，进行程序调试：
(py3.10) ➜ pdb_test git:(master) ✗ python mydebugger.py pdbusage.py
(Pdb)n
debugging line: def m99():
(Pdb)n
debugging line: if __name__ == '__main__':
(Pdb)n
debugging line: m99()
(Pdb)n
debugging line: for i in range(1, 10):
(Pdb)n
debugging line: for j in range(1, i + 1):
(Pdb)n
debugging line: print(f"{i}x{j}={i*j}", end='\t')
1x1=1 (Pdb)n
debugging line: for j in range(1, i + 1):
(Pdb)p i
1
(Pdb)p j
1
(Pdb)q
(py3.10) ➜ pdb_test git:(master) ✗
可以看到我们的程序真正的被调试起来了。
现在我们来分析一下我们自己实现的简易版本的调试器，在前文当中我们已经提到了 sys.settrace 函数，调用这个函数时需要传递一个函数作为参数，被传入的函数需要接受三个参数：
frame，当前正在执行的栈帧。
event，事件的类别，这一点在前面的文件当中已经提到了。
arg，参数这一点在前面也已经提到了。
同时需要注意的是这个函数也需要有一个返回值，python 虚拟机在下一次事件发生的时候会调用返回的这个函数，如果返回 None 那么就不会在发生事件的时候调用 tracing 函数了，这是代码当中为什么在 debug 返回 debug 的原因。
我们只对 line 这个事件进行处理，然后进行死循环，只有输入 n 指令的时候才会执行下一行，然后打印正在执行的行，这个时候就会退出函数 debug ，程序就会继续执行了。python 内置的 eval 函数可以获取变量的值。
python 官方的调试器为 pdb 这个是 python 标准库自带的，我们可以通过 python -m pdb xx.py 去调试文件 xx.py 。这里我们只分析核心代码：
代码位置：bdp.py 下面的 Bdb 类
def run(self, cmd, globals=None, locals=None):
"""Debug a statement executed via the exec() function.
globals defaults to __main__.dict; locals defaults to globals.
"""
if globals is None:
import __main__
globals = __main__.__dict__
if locals is None:
locals = globals
self.reset()
if isinstance(cmd, str):
cmd = compile(cmd, "<string>", "exec")
sys.settrace(self.trace_dispatch)
try:
exec(cmd, globals, locals)
except BdbQuit:
pass
finally:
self.quitting = True
sys.settrace(None)上面的函数主要是使用 sys.settrace 函数进行 tracing 操作，当有事件发生的时候就能够捕捉了。在上面的代码当中 tracing 函数为 self.trace_dispatch 我们再来看这个函数的代码：
def trace_dispatch(self, frame, event, arg):
"""Dispatch a trace function for debugged frames based on the event.
This function is installed as the trace function for debugged
frames. Its return value is the new trace function, which is
usually itself. The default implementation decides how to
dispatch a frame, depending on the type of event (passed in as a
string) that is about to be executed.
The event can be one of the following:
line: A new line of code is going to be executed.
call: A function is about to be called or another code block
is entered.
return: A function or other code block is about to return.
exception: An exception has occurred.
c_call: A C function is about to be called.
c_return: A C function has returned.
c_exception: A C function has raised an exception.
For the Python events, specialized functions (see the dispatch_*()
methods) are called. For the C events, no action is taken.
The arg parameter depends on the previous event.
"""
if self.quitting:
return # None
if event == 'line':
print("In line")
return self.dispatch_line(frame)
if event == 'call':
print("In call")
return self.dispatch_call(frame, arg)
if event == 'return':
print("In return")
return self.dispatch_return(frame, arg)
if event == 'exception':
print("In execption")
return self.dispatch_exception(frame, arg)
if event == 'c_call':
print("In c_call")
return self.trace_dispatch
if event == 'c_exception':
print("In c_exception")
return self.trace_dispatch
if event == 'c_return':
print("In c_return")
return self.trace_dispatch
print('bdb.Bdb.dispatch: unknown debugging event:', repr(event))
return self.trace_dispatch从上面的代码当中可以看到每一种事件都有一个对应的处理函数，在本文当中我们主要分析 函数 dispatch_line，这个处理 line 事件的函数。
def dispatch_line(self, frame):
"""Invoke user function and return trace function for line event.
If the debugger stops on the current line, invoke
self.user_line(). Raise BdbQuit if self.quitting is set.
Return self.trace_dispatch to continue tracing in this scope.
"""
if self.stop_here(frame) or self.break_here(frame):
self.user_line(frame)
if self.quitting: raise BdbQuit
return self.trace_dispatch这个函数首先会判断是否需要在当前行停下来，如果需要停下来就需要进入 user_line 这个函数，后面的调用链函数比较长，我们直接看最后执行的函数，根据我们使用 pdb 的经验来看，最终肯定是一个 while 循环让我们可以不断的输入指令进行处理：
def cmdloop(self, intro=None):
"""Repeatedly issue a prompt, accept input, parse an initial prefix
off the received input, and dispatch to action methods, passing them
the remainder of the line as argument.
"""
print("In cmdloop")
self.preloop()
if self.use_rawinput and self.completekey:
try:
import readline
self.old_completer = readline.get_completer()
readline.set_completer(self.complete)
readline.parse_and_bind(self.completekey+": complete")
except ImportError:
pass
try:
if intro is not None:
self.intro = intro
print(f"{self.intro = }")
if self.intro:
self.stdout.write(str(self.intro)+"\n")
stop = None
while not stop:
print(f"{self.cmdqueue = }")
if self.cmdqueue:
line = self.cmdqueue.pop(0)
else:
print(f"{self.prompt = } {self.use_rawinput}")
if self.use_rawinput:
try:
# 核心逻辑就在这里 不断的要求输入然后进行处理
line = input(self.prompt) # self.prompt = '(Pdb)'
except EOFError:
line = 'EOF'
else:
self.stdout.write(self.prompt)
self.stdout.flush()
line = self.stdin.readline()
if not len(line):
line = 'EOF'
else:
line = line.rstrip('\r\n')
line = self.precmd(line)
stop = self.onecmd(line) # 这个函数就是处理我们输入的字符串的比如 p n 等等
stop = self.postcmd(stop, line)
self.postloop()
finally:
if self.use_rawinput and self.completekey:
try:
import readline
readline.set_completer(self.old_completer)
except ImportError:
pass def onecmd(self, line):
"""Interpret the argument as though it had been typed in response
to the prompt.
This may be overridden, but should not normally need to be;
see the precmd() and postcmd() methods for useful execution hooks.
The return value is a flag indicating whether interpretation of
commands by the interpreter should stop.
"""
cmd, arg, line = self.parseline(line)
if not line:
return self.emptyline()
if cmd is None:
return self.default(line)
self.lastcmd = line
if line == 'EOF' :
self.lastcmd = ''
if cmd == '':
return self.default(line)
else:
try:
# 根据下面的代码可以分析了解到如果我们执行命令 p 执行的函数为 do_p
func = getattr(self, 'do_' + cmd)
except AttributeError:
return self.default(line)
return func(arg)现在我们再来看一下 do_p 打印一个表达式是如何实现的：
def do_p(self, arg):
"""p expression
Print the value of the expression.
"""
self._msg_val_func(arg, repr)
def _msg_val_func(self, arg, func):
try:
val = self._getval(arg)
except:
return # _getval() has displayed the error
try:
self.message(func(val))
except:
self._error_exc()
def _getval(self, arg):
try:
# 看到这里就破案了这不是和我们自己实现的 pdb 获取变量的方式一样嘛 都是
# 使用当前执行栈帧的全局和局部变量交给 eval 函数处理 并且将它的返回值输出
return eval(arg, self.curframe.f_globals, self.curframe_locals)
except:
self._error_exc()
raise以上がPython 仮想マシンにおけるデバッガーの実装原理は何ですか?の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。
![[Web フロントエンド] Node.js クイック スタート](https://img.php.cn/upload/course/000/000/067/662b5d34ba7c0227.png)
