Lua Academy · 课时

Lua 5.2+ 中的 _ENV 模型

Q: 「Lua 5.2+ 中的 _ENV 模型」这节课中我会学到什么？

理解 _ENV 如何取代 setfenv，以及它如何实现环境控制。 你通过在浏览器中直接运行的动手代码来练习 Lua Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

理解 _ENV 如何取代 setfenv，以及它如何实现环境控制。

Lua 5.2+ 中的 _ENV 模型 是 CoddyKit 上的免费 Lua Academy 课时。这是第 1 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Lua Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Lua Academy 课程共包含 4 节课。

什么是 _ENV

在 Lua 5.2 及更高版本中，每个代码块都有一个名为 _ENV 的隐式上值。所有全局变量访问都会被重写为对 _ENV 字段的访问。因此，print(x) 会变成 _ENV.print(_ENV.x)。

_ENV 替代 setfenv

在 Lua 5.1 中，setfenv(fn, env) 会更改函数的全局环境。在 5.2 及更高版本中，该函数已被移除。相反，请将 _ENV 设置为局部变量，以更改代码块或代码段的环境。

在代码块中更改 _ENV

请在代码块顶部设置 _ENV，以重定向所有全局访问。

-- Everything in this chunk uses myEnv as globals
local _ENV = myEnv
print("hello")  -- calls myEnv.print("hello")

代码段的局部 _ENV

将 _ENV 的作用域限制在 do...end 代码块内，以限制其影响范围。

do
  local _ENV = {print = print, x = 42}
  print(x)  -- 42 from local _ENV
end
print(x)  -- original _ENV.x (global x)

使用 load 与 _ENV

load(chunk, chunkname, mode, env) 会在自定义环境中将字符串作为代码块执行。这是 5.2 及更高版本中的主要沙箱机制。

local env = {print = print, math = math}
local fn, err = load("print(math.sqrt(16))", "sandbox", "t", env)
if fn then fn() end  -- 4.0

读取当前 _ENV

当前代码块的全局变量位于 _ENV 中。要获取其引用，请使用：local myEnv = _ENV。

在运行时修改 _ENV

设置全局变量的操作是 _ENV.varName = value。由于 _ENV 是一个上值，因此您可以在代码的任意位置将其替换为另一个表。

使用 __index 继承

为沙箱环境设置一个元表，并使用 __index = _G，这样对于未明确阻止的函数，就可以回退到真实的全局表。

local sandboxEnv = setmetatable({}, {__index = _G})
-- then block dangerous ones:
sandboxEnv.os = nil
sandboxEnv.io = nil
sandboxEnv.load = nil

检测 _ENV 访问尝试

将危险的全局变量替换为哨兵，以记录访问尝试，便于进行安全审计。

sandboxEnv.os = setmetatable({}, {
  __index = function(_, k)
    ngx.log(ngx.WARN, "Blocked access: os." .. k)
    return nil
  end
})

兼容性说明

使用 Lua 5.1 的 setfenv/getfenv 的库需要针对 5.2 及更高版本重写。有些库会在初始化代码中使用兼容性垫片。

实际影响

_ENV 模型让沙箱机制更加清晰且一致。它为环境提供了一种明确的机制，而不是将两种机制并存（函数使用 setfenv，而顶层代码使用全局变量）。

_ENV 问题

Lua 5.2 及更高版本如何重写全局访问 print(x)？

回顾：_ENV 模型

Lua 5.2 及更高版本会让所有全局访问都通过 _ENV 上值进行。使用 load(code, name, "t", env) 在自定义环境中执行代码。这是替代 setfenv 的标准沙箱机制。

常见问题解答

「Lua 5.2+ 中的 _ENV 模型」课时是免费的吗？

是的 — 「Lua 5.2+ 中的 _ENV 模型」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Lua Academy 课程的其余内容，请升级到 CoddyKit PRO。 Lua Academy 课程共包含 4 节课。

「Lua 5.2+ 中的 _ENV 模型」这节课中我会学到什么？

理解 _ENV 如何取代 setfenv，以及它如何实现环境控制。你通过在浏览器中直接运行的动手代码来练习 Lua Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Lua Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Lua Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 1 节课，共 4 节。

「Lua 5.2+ 中的 _ENV 模型」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Lua Academy 课中编写并运行代码吗？

能。每节 Lua Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Lua Academy