Lua无法创建对象：调用nil值setmetatable问题排查

问题详情 #

代码示例 #

Target = {}
Target.__index = Target

function Target.new(isfound,distance,azimuth_angle,elevation_angle,time_since_detected)
    local instance = setmetatable({},Target)
    instance.isfound = isfound
    instance.distance = distance
    instance.azimuth_angle = azimuth_angle
    instance.elevation_angle = elevation_angle
    instance.time_since_detected = time_since_detected
    return instance
end

function Target:CalculateXY(maxDistance,radius,radarAngle)
    distancePx = (self.distance/maxDistance)*radius 
    x2 = w / 2 + distancePx * math.cos(1.58+radarAngle)
    y2 = h / 2 + distancePx * math.sin(1.58+radarAngle)
    data = {x = x2, y= y2}
    return data
end

function Target:GetIsFound()
    return self.isfound
end

报错信息 #

Exception has occurred: attempt to call a nil value (global 'setmetatable')

报错触发行 #

local instance = setmetatable({},Target)

使用环境：VS Code + sumneko.lua 3.5.6版本Lua语言服务

原因分析 #

1. 运行环境缺少标准库支持
   setmetatable是Lua标准库的核心函数，出现该错误说明当前运行代码的Lua环境未加载这个函数。常见于阉割版Lua环境（比如嵌入式设备、部分游戏引擎的受限Lua runtime），这类环境会裁剪部分标准库功能以节省资源。

2. 编辑器与运行环境不匹配
   sumneko.lua语言服务仅提供语法提示和静态检查，它模拟的环境和你实际运行代码的Lua环境可能不一致。比如编辑器配置了完整的Lua标准库，但实际运行时使用的是被修改过的环境，导致setmetatable未被注册为全局函数。

3. 全局变量被意外覆盖
   虽然你提供的代码中没有相关操作，但如果代码其他部分存在setmetatable = nil这类赋值语句，也会导致该错误。不过从现有代码来看，这种可能性极低。

核心结论：运行代码的Lua环境中不存在setmetatable全局函数，调用时触发了"调用nil值"的错误。

内容的提问来源于stack exchange，提问作者KRIShark