多个返回值
从一次函数调用中返回并接收多个值。
多个返回值 是 CoddyKit 上的免费 Lua Academy 课时。 这是第 2 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Lua Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Lua Academy 课程共包含 4 节课。
返回多个值
与大多数语言不同，Lua 函数可以原生地通过一条 return 语句返回多个值。多个值写在 return 后面，并用逗号分隔。这样就不需要包装对象或输出参数。
local function divmod(a, b)
return math.floor(a / b), a % b
end
local quotient, remainder = divmod(17, 5)
print(quotient, remainder) -- 3 2调整返回值
Lua 会调整返回值，使其数量与接收方的数量相匹配。多余的值会被丢弃；缺少的值会变成 nil。当函数调用不是列表中的最后一个表达式时，就会进行这种调整——在这种位置上，只会保留第一个值。
local function triple()
return 10, 20, 30
end
local a, b, c = triple()
print(a, b, c) -- 10 20 30
local x, y = triple()
print(x, y) -- 10 20 (30 discarded)
local p = triple()
print(p) -- 10 (only first when 1 var)中间位置的调整
当函数调用出现在表达式列表的中间位置（不是最后一个位置）时，Lua 会将其截断为单个值。只有列表中的最后一个表达式才能产生多个值。
local function pair()
return 1, 2
end
-- pair() in middle: only 1 value used
local t = {pair(), pair()}
print(#t, t[1], t[2], t[3]) -- 3 1 1 2
-- first pair() gives just 1; last pair() gives 1,2
-- pair() at end: all values used
local t2 = {10, pair()}
print(#t2, t2[1], t2[2], t2[3]) -- 3 10 1 2括号强制返回单个值
用括号包围函数调用，会强制它恰好返回一个值。当您无论函数产生多少个返回值都只需要第一个值时，这种写法非常有用。
local function coords()
return 10, 20, 30
end
print(coords()) -- 10 20 30 (all three)
print((coords())) -- 10 (parentheses: single value only)
local x = (coords())
print(x) -- 10string.find 的返回值
许多标准库函数都会返回多个值。string.find 返回匹配项的起始位置和结束位置（以及捕获内容）。math.modf 返回整数部分和小数部分。理解这些模式有助于您熟练使用标准库。
local s = "hello world"
local start, finish = string.find(s, "world")
print(start, finish) -- 7 11
-- math.modf: integer and fractional parts
local int, frac = math.modf(3.75)
print(int, frac) -- 3 0.75使用 table.pack 捕获值
table.pack(...) 会将所有参数（或通过 ... 传入的返回值）捕获到一个表中。该表包含字段 n，记录参数总数，包括 nil 值。与遇到第一个空缺就停止的 # 不同，这样可以保留确切的数量。
local function getData()
return "Alice", 30, nil, true
end
local t = table.pack(getData())
print(t.n) -- 4
print(t[1]) -- Alice
print(t[2]) -- 30
print(t[3]) -- nil
print(t[4]) -- true使用 table.unpack 展开值
table.unpack(t, i, j) 会将表中的元素作为独立值返回。它是 table.pack 的逆操作。您可以使用它将表的内容作为参数传递给函数，或在 return 语句中展开多个值。
local args = {10, 20, 30}
local function sum3(a, b, c)
return a + b + c
end
print(sum3(table.unpack(args))) -- 60
-- Use in return
local function passThrough(t)
return table.unpack(t)
end
print(passThrough({5, 6, 7})) -- 5 6 7错误风格的返回值
Lua 中一种常见约定是在失败时返回 nil, errorMessage，成功时返回结果。调用方会检查第一个返回值：如果是 nil，就表示发生了错误。对于预期可能失败的情况，这种方式可以避免使用异常。
local function openConfig(path)
local f = io.open(path, "r")
if not f then
return nil, "cannot open: " .. path
end
local content = f:read("*a")
f:close()
return content
end
local data, err = openConfig("config.lua")
if not data then
print("Error:", err)
end使用多个返回值交换值
多个返回值可以优雅地解决交换值的问题。赋值前会先计算右侧表达式，因此 a, b = b, a 无需临时变量就能正确交换两个值。
local a, b = 5, 10
print(a, b) -- 5 10
a, b = b, a
print(a, b) -- 10 5
-- Works for three-way rotation too
local x, y, z = 1, 2, 3
x, y, z = z, x, y
print(x, y, z) -- 3 1 2pcall 的返回约定
pcall(f, ...) 本身也使用多个返回值：第一个值是布尔值（成功时为 true，出错时为 false），后续值要么是 f 的返回值，要么是错误信息。在使用其余返回值之前，请始终先检查第一个返回值。
local function risky(x)
if x < 0 then error("negative input") end
return math.sqrt(x)
end
local ok, result = pcall(risky, 16)
print(ok, result) -- true 4.0
ok, result = pcall(risky, -1)
print(ok, result) -- false input:2: negative input快速检查
print((string.find("hello", "ll"))) 会输出什么？
回顾：多个返回值
要点总结：
- 返回多个值：
return a, b, c - 多余的值会被丢弃；缺少的值会变成 nil
- 处于中间位置的函数调用会被截断为一个值
(f())会强制只返回一个值- 使用
table.pack/table.unpack处理动态值列表 - 约定：失败时返回
nil, errmsg
常见问题解答
「多个返回值」课时是免费的吗？
是的 — 「多个返回值」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Lua Academy 课程的其余内容，请升级到 CoddyKit PRO。 Lua Academy 课程共包含 4 节课。
「多个返回值」这节课中我会学到什么？
从一次函数调用中返回并接收多个值。 你通过在浏览器中直接运行的动手代码来练习 Lua Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Lua Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Lua Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 2 节课，共 4 节。
「多个返回值」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Lua Academy 课中编写并运行代码吗？
能。每节 Lua Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。