Lua Academy · Aula

A biblioteca debug

Inspecione rastreamentos de pilha, variáveis locais e upvalues com a biblioteca debug.

A biblioteca debug é uma aula grátis de Lua Academy no CoddyKit. Esta é a aula 4 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Lua Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Lua Academy inclui 4 aulas no total.

O que é a biblioteca debug?

A biblioteca debug fornece acesso de baixo nível aos componentes internos do Lua: quadros da pilha, variáveis locais, valores ascendentes, ganchos e estado de corrotinas. Use-a para depuração, não para a lógica de produção.

debug.traceback

debug.traceback(msg, level) retorna uma string com a pilha de chamadas. É geralmente passada a xpcall como manipulador de erros.

local ok, err = xpcall(function()
  error("something went wrong")
end, debug.traceback)
print(err)

debug.getinfo

debug.getinfo(fn, what) retorna uma tabela com informações sobre uma função: nome, origem, linha em que foi definida etc.

local function foo() end
local info = debug.getinfo(foo, "Sl")
print(info.source, info.linedefined)

Inspeção do nível da pilha

Passe um inteiro a debug.getinfo para inspecionar um quadro específico da pilha. O nível 1 é a função atual; o 2 é o chamador.

local function where()
  local info = debug.getinfo(2, "Sl")
  return info.short_src .. ":" .. info.currentline
end
print(where())

debug.getlocal e debug.setlocal

debug.getlocal(level, n) retorna o nome e o valor da enésima variável local em um quadro da pilha.

local function example()
  local x = 42
  print(debug.getlocal(1, 1))  -- x  42
end
example()

debug.getupvalue e debug.setupvalue

Inspecione e modifique os valores ascendentes de uma função. getupvalue(fn, n) retorna o nome e o valor.

local x = 10
local function f() return x end
print(debug.getupvalue(f, 1))  -- x  10
debug.setupvalue(f, 1, 99)
print(f())  -- 99

debug.sethook

debug.sethook(fn, mask, count) define um gancho chamado em eventos: "c" (chamada), "r" (retorno), "l" (linha) ou a cada N instruções.

local calls = 0
debug.sethook(function() calls = calls + 1 end, "c")
-- ... run some code ...
debug.sethook()  -- remove hook
print("calls:", calls)

debug.getmetatable

debug.getmetatable(obj) recupera a metatabela mesmo quando getmetatable está bloqueada por um campo __metatable.

debug.upvalueid e upvaluejoin

debug.upvalueid(fn, n) retorna um identificador exclusivo para um valor ascendente. debug.upvaluejoin(f1,n1,f2,n2) faz com que compartilhem a mesma célula.

Cuidado: riscos da biblioteca debug

A biblioteca debug pode violar o encapsulamento e quebrar invariantes. Nunca a use em código de produção. Reserve-a para testes, criação de perfis e ferramentas de desenvolvimento.

debug.traceback em xpcall

O uso mais comum e seguro da biblioteca debug em produção é passar debug.traceback como manipulador de erros para xpcall, obtendo mensagens de erro detalhadas.

Pergunta sobre a biblioteca debug

Qual função de debug é segura e comumente usada no tratamento de erros em produção?

Recapitulação: biblioteca debug

A biblioteca debug expõe quadros da pilha, variáveis locais, valores ascendentes e ganchos. Use debug.traceback com xpcall para obter erros detalhados; trate o restante como ferramentas de introspecção exclusivas para desenvolvedores.

Perguntas Frequentes

A aula “A biblioteca debug” é grátis?

Sim — o texto completo de “A biblioteca debug” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Lua Academy, atualize para CoddyKit PRO. O curso de Lua Academy inclui 4 aulas no total.

O que vou aprender em “A biblioteca debug”?

Inspecione rastreamentos de pilha, variáveis locais e upvalues com a biblioteca debug. Você pratica Lua Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar Lua Academy?

Nenhuma experiência prévia é necessária. Lua Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 4 de 4.

Quanto tempo leva a aula “A biblioteca debug”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de Lua Academy?

Sim. Cada aula de Lua Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

← Voltar para Lua Academy