Lua Academy · Leçon

La bibliothèque debug en profondeur

Utilisez debug.traceback, getinfo, getlocal et getupvalue pour l’introspection.

La bibliothèque debug en profondeur est une leçon Lua Academy gratuite sur CoddyKit. Ceci est la leçon 1 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Lua Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Lua Academy comprend 4 leçons au total.

Présentation de la bibliothèque debug

La bibliothèque debug est la boîte à outils d'introspection de Lua. Elle permet d'inspecter et de modifier l'état d'exécution de toute fonction, coroutine ou cadre de pile.

Exploration approfondie de debug.getinfo

debug.getinfo(f, what) accepte des indicateurs what : "n" (nom), "S" (source), "l" (ligne actuelle), "u" (valeurs externes), "f" (référence de fonction).

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()

Inspection des variables locales

debug.getlocal(level, n) renvoie le nom et la valeur de la n-ième variable locale à un niveau de pile donné. Le niveau 1 correspond à la fonction actuelle.

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

Modification des variables locales

debug.setlocal(level, n, value) modifie à l'exécution la valeur d'une variable locale — une fonctionnalité puissante pour le débogage et les tests.

Inspection des valeurs externes

debug.getupvalue(fn, n) renvoie le nom et la valeur de la n-ième valeur externe d'une fonction. Itérez en augmentant n jusqu'à ce que nil soit renvoyé.

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

Parcours de la pile

Parcourez toute la pile d'appels en augmentant le niveau jusqu'à ce que debug.getinfo renvoie nil.

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) renvoie une chaîne de caractères contenant une trace de pile formatée. C'est la fonction de débogage la plus pratique pour la gestion des erreurs en production.

Inspection des coroutines

Passez une coroutine comme premier argument à debug.getinfo pour inspecter sa pile.

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

debug.sethook pour le traçage

Tracez tous les appels de fonction d'un programme en définissant une fonction d'interception des appels qui affiche les noms des fonctions.

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

Assertions portables

Utilisez debug.getinfo(2, "Sl") pour inclure les informations sur le fichier et la ligne dans les erreurs d'assertion.

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

Attention

La bibliothèque de débogage peut violer l'encapsulation, ralentir considérablement les programmes (en particulier avec debug.sethook) et ne pas être disponible dans tous les environnements. Utilisez-la uniquement pendant le développement et les tests.

Question sur la bibliothèque debug

Que renvoie debug.getupvalue(fn, 1) ?

Récapitulatif : la bibliothèque debug en profondeur

La bibliothèque debug fournit l'inspection de la pile (getinfo), l'inspection et la modification des variables locales (getlocal/setlocal), l'accès aux valeurs externes (getupvalue/setupvalue) ainsi que le traçage fondé sur des fonctions d'interception (sethook). Utilisez-la de manière responsable et uniquement pendant le développement.

Questions Fréquemment Posées

La leçon « La bibliothèque debug en profondeur » est-elle gratuite ?

Oui — le texte complet de « La bibliothèque debug en profondeur » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Lua Academy, passe à CoddyKit PRO. Le cours Lua Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « La bibliothèque debug en profondeur » ?

Utilisez debug.traceback, getinfo, getlocal et getupvalue pour l’introspection. Tu pratiques Lua Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer Lua Academy ?

Aucune expérience préalable n'est requise. Lua Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 1 sur 4.

Combien de temps prend la leçon « La bibliothèque debug en profondeur » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon Lua Academy ?

Oui. Chaque leçon Lua Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

La bibliothèque debug en profondeur
Débogage à distance avec MobDebug
Profilage avec LuaProfiler
Couverture du code et instrumentation des tests

← Retour à Lua Academy