Lua Academy · Lektion

Die debug-Bibliothek im Detail

Verwenden Sie debug.traceback, getinfo, getlocal und getupvalue zur Introspektion

Die debug-Bibliothek im Detail ist eine kostenlose Lua Academy-Lektion auf CoddyKit. Dies ist Lektion 1 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des Lua Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der Lua Academy-Kurs umfasst insgesamt 4 Lektionen.

Überblick über die debug-Bibliothek

Die debug-Bibliothek ist das Werkzeug von Lua zur Laufzeitintrospektion. Sie ermöglicht es Ihnen, den Laufzeitstatus jeder Funktion, Coroutine oder jedes Stack-Frames zu untersuchen und zu ändern.

debug.getinfo im Detail

debug.getinfo(f, what) akzeptiert what-Flags: "n" (Name), "S" (Quelle), "l" (aktuelle Zeile), "u" (Upvalues), "f" (Funktionsreferenz).

local function foo()
  local info = debug.getinfo(1, "nSlu")
  print(info.name)        -- foo
  print(info.short_src)   -- source file
  print(info.currentline) -- line number
  print(info.nups)        -- number of upvalues
end
foo()

Lokale Variablen untersuchen

debug.getlocal(level, n) gibt den Namen und den Wert der n-ten lokalen Variablen auf einer bestimmten Stack-Ebene zurück. Ebene 1 = aktuelle Funktion.

local function example()
  local x, y = 10, 20
  local i = 1
  while true do
    local name, val = debug.getlocal(1, i)
    if not name then break end
    print(name, val)
    i = i + 1
  end
end
example()  -- x 10 / y 20

Lokale Variablen ändern

debug.setlocal(level, n, value) ändert den Wert einer lokalen Variablen zur Laufzeit – leistungsfähig für Debugging und Tests.

Upvalues untersuchen

debug.getupvalue(fn, n) gibt den Namen und den Wert des n-ten Upvalues einer Funktion zurück. Erhöhen Sie n schrittweise, bis nil zurückgegeben wird.

local count = 0
local function inc() count = count + 1 end
print(debug.getupvalue(inc, 1))  -- count  0
debug.setupvalue(inc, 1, 99)
inc()
print(count)  -- 100

Stack durchlaufen

Durchlaufen Sie den gesamten Aufruf-Stack, indem Sie die Ebene erhöhen, bis debug.getinfo nil zurückgibt.

local function printStackTrace()
  local level = 1
  while true do
    local info = debug.getinfo(level, "Sln")
    if not info then break end
    print(level, info.short_src, info.currentline, info.name)
    level = level + 1
  end
end

debug.traceback

debug.traceback(msg, level) gibt einen formatierten Stack-Trace als Zeichenfolge zurück. Die praktischste Debug-Funktion für die Fehlerbehandlung im Produktiveinsatz.

Coroutinen untersuchen

Übergeben Sie eine Coroutine als erstes Argument an debug.getinfo, um deren Stack zu untersuchen.

local co = coroutine.create(function()
  print(debug.getinfo(1, "l").currentline)
end)
coroutine.resume(co)

debug.sethook zur Ablaufverfolgung

Verfolgen Sie alle Funktionsaufrufe in einem Programm, indem Sie einen Call-Hook setzen, der die Funktionsnamen ausgibt.

debug.sethook(function(event)
  if event == "call" then
    local info = debug.getinfo(2, "Sn")
    print("CALL:", info.name or "?")
  end
end, "c")

Portierbare Assertions

Verwenden Sie debug.getinfo(2, "Sl"), um Dateiname und Zeilennummer in Assertion-Fehlermeldungen aufzunehmen.

local function assert2(cond, msg)
  if not cond then
    local info = debug.getinfo(2, "Sl")
    error(("[%s:%d] %s"):format(info.short_src, info.currentline, msg), 2)
  end
end

Vorsicht

Die debug-Bibliothek kann die Kapselung verletzen, Programme deutlich verlangsamen (insbesondere debug.sethook) und ist nicht in allen Umgebungen verfügbar. Verwenden Sie sie nur bei Entwicklung und Tests.

Frage zur debug-Bibliothek

Was gibt debug.getupvalue(fn, 1) zurück?

Zusammenfassung: Die debug-Bibliothek im Detail

Die debug-Bibliothek ermöglicht die Untersuchung des Stacks (getinfo), die Untersuchung und Änderung lokaler Variablen (getlocal/setlocal), den Zugriff auf Upvalues (getupvalue/setupvalue) sowie die Ablaufverfolgung über Hooks (sethook). Verwenden Sie sie verantwortungsvoll und nur bei der Entwicklung.

Häufig gestellte Fragen

Ist die Lektion „Die debug-Bibliothek im Detail“ kostenlos?

Ja — der vollständige Text von „Die debug-Bibliothek im Detail“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des Lua Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der Lua Academy-Kurs umfasst insgesamt 4 Lektionen.

Was lerne ich in „Die debug-Bibliothek im Detail“?

Verwenden Sie debug.traceback, getinfo, getlocal und getupvalue zur Introspektion Du übst Lua Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.

Brauche ich Erfahrung, um Lua Academy zu starten?

Keine Vorkenntnisse erforderlich. Lua Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 1 von 4.

Wie lange dauert die Lektion „Die debug-Bibliothek im Detail“?

Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.

Kann ich in dieser Lua Academy-Lektion Code schreiben und ausführen?

Ja. Jede Lua Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.

Alle Lektionen in diesem Kurs

← Zurück zu Lua Academy