0Pricing
Lua Academy · Урок

Подробно о библиотеке debug

Используйте debug.traceback, getinfo, getlocal и getupvalue для самоанализа.

«Подробно о библиотеке debug» — бесплатный урок Lua Academy на CoddyKit. Это урок 1 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения Lua Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс Lua Academy содержит 4 уроков всего.

Обзор библиотеки отладки

Библиотека debug — это набор средств интроспекции Lua. Она позволяет проверять и изменять состояние среды выполнения любой функции, корутины или кадра стека.

Подробный разбор debug.getinfo

debug.getinfo(f, what) принимает флаги what: "n" (имя), "S" (исходный код), "l" (текущая строка), "u" (внешние значения), "f" (ссылка на функцию).

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

Проверка локальных переменных

debug.getlocal(level, n) возвращает имя и значение n-й локальной переменной на заданном уровне стека. Уровень 1 — текущая функция.

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

Изменение локальных переменных

debug.setlocal(level, n, value) изменяет значение локальной переменной во время выполнения — это мощный инструмент для отладки и тестирования.

Проверка внешних значений

debug.getupvalue(fn, n) возвращает имя и значение n-го внешнего значения функции. Перебирайте значения, увеличивая n, пока не будет возвращено nil.

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

Обход стека

Пройдите весь стек вызовов, увеличивая уровень, пока debug.getinfo не вернёт 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) возвращает строку с форматированной трассировкой стека. Это самая практичная функция отладки для обработки ошибок в рабочем окружении.

Проверка корутин

Передайте корутину первым аргументом в debug.getinfo, чтобы проверить её стек.

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

debug.sethook для трассировки

Трассируйте все вызовы функций в программе, установив обработчик вызовов, который выводит имена функций.

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

Переносимые утверждения

Используйте debug.getinfo(2, "Sl"), чтобы включить сведения о файле и строке в ошибки утверждений.

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

Внимание

Библиотека отладки может нарушать инкапсуляцию, значительно замедлять программы (особенно debug.sethook) и быть недоступной в некоторых окружениях. Используйте её только при разработке и тестировании.

Вопрос о библиотеке debug

Что возвращает debug.getupvalue(fn, 1)?

Итоги: библиотека debug подробно

Библиотека отладки предоставляет средства проверки стека (getinfo), проверки и изменения локальных переменных (getlocal/setlocal), доступа к внешним значениям (getupvalue/setupvalue) и трассировки на основе обработчиков (sethook). Используйте её ответственно и только при разработке.

Часто задаваемые вопросы

Урок «Подробно о библиотеке debug» бесплатный?

Да — полный текст урока «Подробно о библиотеке debug» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс Lua Academy, подпишись на CoddyKit PRO. Курс Lua Academy содержит 4 уроков всего.

Чему я научусь в уроке «Подробно о библиотеке debug»?

Используйте debug.traceback, getinfo, getlocal и getupvalue для самоанализа. Ты практикуешь Lua Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать Lua Academy?

Предыдущий опыт не требуется. Lua Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 1 из 4.

Сколько времени занимает урок «Подробно о библиотеке debug»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке Lua Academy?

Да. Каждый урок Lua Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

  1. Подробно о библиотеке debug
  2. Удалённая отладка с MobDebug
  3. Профилирование с LuaProfiler
  4. Покрытие кода и инструментирование тестов
← Назад к Lua Academy