debug 库
使用 debug 库检查堆栈回溯、局部变量和上值。
debug 库 是 CoddyKit 上的免费 Lua Academy 课时。 这是第 4 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Lua Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Lua Academy 课程共包含 4 节课。
什么是 debug 库？
debug 库提供对 Lua 内部机制的底层访问：栈帧、局部变量、上值、钩子和协程状态。请将它用于调试，而不要用于生产逻辑。
debug.traceback
debug.traceback(msg, level) 返回包含调用栈的字符串。它通常作为错误处理函数传递给 xpcall。
local ok, err = xpcall(function()
error("something went wrong")
end, debug.traceback)
print(err)debug.getinfo
debug.getinfo(fn, what) 返回一个包含函数信息的表：名称、源文件、定义所在行等。
local function foo() end
local info = debug.getinfo(foo, "Sl")
print(info.source, info.linedefined)检查栈层级
向 debug.getinfo 传入整数，可以检查特定的栈帧。层级 1 是当前函数，层级 2 是调用者。
local function where()
local info = debug.getinfo(2, "Sl")
return info.short_src .. ":" .. info.currentline
end
print(where())debug.getlocal 和 debug.setlocal
debug.getlocal(level, n) 返回栈帧中第 n 个局部变量的名称和值。
local function example()
local x = 42
print(debug.getlocal(1, 1)) -- x 42
end
example()debug.getupvalue 和 debug.setupvalue
检查并修改函数的上值。getupvalue(fn, n) 返回名称和值。
local x = 10
local function f() return x end
print(debug.getupvalue(f, 1)) -- x 10
debug.setupvalue(f, 1, 99)
print(f()) -- 99debug.sethook
debug.sethook(fn, mask, count) 设置一个钩子，在以下事件发生时调用："c"（调用）、"r"（返回）、"l"（行），或每执行 N 条指令时调用。
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) 即使 getmetatable 被 __metatable 字段阻止，也能获取元表。
debug.upvalueid 和 upvaluejoin
debug.upvalueid(fn, n) 返回上值的唯一标识符。debug.upvaluejoin(f1,n1,f2,n2) 让它们共享同一个存储单元。
注意：debug 库的风险
debug 库可能破坏封装并破坏不变量。绝不要在生产代码中使用它。请仅将它用于测试、性能分析和开发工具。
xpcall 中的 debug.traceback
debug 最常见且适合生产环境的用法，是将 debug.traceback 作为错误处理函数传递给 xpcall，以获得详细的错误信息。
debug 库问题
哪个 debug 函数适合用于生产环境中的错误处理，并且使用最为普遍？
回顾：debug 库
debug 库公开了栈帧、局部变量、上值和钩子。请将 debug.traceback 与 xpcall 搭配使用以获得详细错误信息；其余功能应视为仅供开发者使用的自省工具。
用 AI 导师学习 Lua — 免费
在浏览器中编写并运行真实代码，获得全天候 AI 导师的即时帮助，并在网页或应用中继续学习。
- 课程
- 40
- 课程
- 159
常见问题解答
「debug 库」课时是免费的吗？
是的 — 「debug 库」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Lua Academy 课程的其余内容，请升级到 CoddyKit PRO。 Lua Academy 课程共包含 4 节课。
「debug 库」这节课中我会学到什么？
使用 debug 库检查堆栈回溯、局部变量和上值。 你通过在浏览器中直接运行的动手代码来练习 Lua Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Lua Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Lua Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 4 节课，共 4 节。
「debug 库」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Lua Academy 课中编写并运行代码吗？
能。每节 Lua Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。