最稳定可控的go→lua回调路径是注册func(*lua.lstate) int函数；必须显式l.pushxxx()返回值并return数量，参数下标从1起，禁存go指针，避免阻塞调用与栈错位。
直接用 gopher-lua 注册 Go 函数供 Lua 调用，是最稳定、最可控的回调路径；别试图在 Lua 里保存 Go 对象指针或跨协程传 *lua.LState，那只会触发 panic。
注册 Go 函数给 Lua 调用的正确签名
Go 函数必须严格满足 func(*lua.LState) int 签名，且返回值是「压入栈的返回值个数」。漏写 return 1 或写成 return 都会导致栈错位，后续 L.Get(-1) 取到错误值甚至 panic。
-
L.ToInt(1)、L.ToString(2)这类取参函数下标从 1 开始，不是 0 - 所有返回值必须用
L.PushXXX()显式压栈，不能靠闭包隐式返回 - 如果 Lua 函数声明了多个返回值（如
return a, b, c），Go 回调也得压入对应数量并返回该数字
避免在 Lua 中持有 Go 对象引用
gopher-lua 的 GC 不感知 Go 的内存生命周期。常见错误是把 *http.Request 或自定义 struct 指针存进 Lua 表，之后 Go 层对象被回收，Lua 再访问就报 panic: runtime error: invalid memory address or nil pointer dereference，堆栈却停在 L.Call 或 L.GetField。
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 传数据只传值（
L.LString、L.LNumber）或深拷贝后的 map/slice（用L.NewTable()构建，别用make(map[string]interface{})） - 若真需回调 Go 方法，应封装成闭包函数再注册，例如：
L.SetGlobal("on_data", L.NewFunction(func(L *lua.LState) int { handleData(L.ToString(1)); return 0 })) - 禁止在 Lua 协程中调用
time.Sleep或阻塞 IO ——gopher-lua不支持抢占式调度，整个 VM 会卡死
从 Lua 主动触发 Go 回调的典型模式
不是所有场景都适合“Go 调 Lua”，更多时候是 Lua 解析完配置或事件后，需要通知 Go 层做实际 I/O 或状态变更。这时推荐用全局钩子函数 + 参数透传：
- 启动时注册一次：
L.SetGlobal("emit_event", L.NewFunction(emitEvent)) - Lua 侧调用：
emit_event("user_login", { user_id = 123, ip = "192.168.1.1" }) - Go 侧
emitEvent函数里用L.CheckString(1)取事件名，用L.ToTable(2)转为表，再遍历字段提取键值 - 注意：
L.ToTable返回的是*lua.LTable，字段访问必须用L.GetField(tbl, "user_id")，不能用map[string]interface{}强转
真正容易被忽略的是错误传播链：Lua 里 error("xxx") 会转成 Go 的 error 类型，但如果你用 L.LoadString + L.Call 手动执行，没包 defer func(){...}() 捕获 panic，就会让整个 Go 进程崩溃。生产环境务必用 L.DoString 或 L.DoFile，它们内部已做了 recover。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
