Lua pcall：环境探测与安全调用

【语法】
一、机制原理
抛个坑：前端引擎版本不一，新版有某个渲染接口，旧版压根没有，脚本一加载直接撞上 attempt to call a nil value 整页瘫痪——怎么先探明环境再动手？pcall 就是探针：以保护模式调用函数，出错不中断脚本，而是返回 false 加错误信息。用它包住对可疑接口的首次访问，返回 true 说明环境支持，false 则走降级路径。机制上，pcall 把被调函数隔离在保护帧里，错误沿调用栈回退到这一帧被截住，主流程毫发无损。版本探测、可选功能开关、第三方库缺失兜底，全是它的主场。
二、错误写法

-- 错误：直接调用，旧版引擎当场报错停摆
local img = createRenderNode(cfg.path)

三、正确写法

local ok, img = pcall(function()
    return createRenderNode(cfg.path)
end)
if not ok then
    img = nil
    logMiss("createRenderNode")
end
local p = getplayerbyname("pcl01")
sendmsg(p, 1, "probed ok=" .. tostring(ok))

四、引擎验证
支持该接口的版本走正常渲染；缺失版本捕获错误走降级分支，页面照常打开；探测结果缓存一次，后续不再重复试探。
五、FAQ
问：pcall 会吞掉所有错误吗？
答：只截住本次调用的运行时错误，内存耗尽等致命错误不保证。
问：探测结果要缓存吗？
答：要，首次探测后记录布尔值，热路径直接走分支。