我先说说我为什么要这么做，因为我在某个开源项目看到了有人把lua移植到了esp32并且可以跑lua脚本语言，我就使用这些开源了的比如ESP8266-lua尝试运行，运行完成就感觉脚本语言最方便，可以在不用编译，刷写固件就可以更新，做任务，更新，我就想我能不能把lvgl封装给lua，然后使用lua调用lvgl在C语言这边的api实现界面，经过我十几天的尝试，结果成功了，现在把教程分享出来，让大伙都可以封装自己的专属lua对接单片机库，方便提高效率
1.你必须学习lua语言，但这个不难程序员学习编程语言也就是一两天的事情，边做边学也行
2.lvgl的显示，刷新全部是在cpp这边刷新的，lua不干扰cpp这边的lvgl的渲染，显示，接线方式，驱动全部由底层C驱动完成
3.包含按键组的事件处理也是由c语言这边处理，lua这边只要提供一个group api就行了
4.本教程使用lvgl 8.4和Arduino esp32
先讲讲实现思路
lv_obj_t * btn = lv_btn_create(lv_scr_act());
先看看这个btn变量，其它它是分配在堆内存里面的，可以动态生成的， lv_btn_create(lv_scr_act()); 它返回的是一个内存地址，内存地址保存在btn这个变量里面，lv_obj_t * btn = lv_btn_create(lv_scr_act()); 如果我们给它执行十次，它的btn变量就会被刷新十次，由于变量的覆盖原则，前九次的btn的内存地址已经失踪了，但它还在内存里面，因为堆内存是要自己手动free的，只是前九次的执行都把内存地址都丢失了，属于内存泄漏了，因为内存地址这片区域还在内存里面，但指针已经丢了，你想free是不可能的，因为你已经得不到了之前的内存地址
所以呢我们就的得准备好一个内存地址存储池 pool，把这些创建的内存地址都存放到这边，提供malloc get free这些方法进行操作，malloc就是申请，get就是获取，free就是释放，三部曲，我们看看是怎么实现内存池的

#include <vector>
#include <Arduino.h>
std::vector<void> pool;
std::vector<int> index_s;
int obj_num = 0;
extern int alloc_handle(void ptr){
if(ptr == nullptr) return 0;
obj_num = obj_num + 1;
pool.push_back(ptr);
index_s.push_back(obj_num);
Serial.println("obj id=");
Serial.println(obj_num);
Serial.println("----------------------");
return obj_num;
}

extern void* get_ptr(int handle) {
if(handle == 0) return nullptr;
for (int i = 0; i < index_s.size(); ++i) {
if (index_s == handle) {
Serial.println("found=");
Serial.println(handle);
Serial.println("----------------------");
return pool; // 返回找到的索引

}
return nullptr;
}

extern void free_handle(int handle) {
if(handle == 0) return;
for (int i = 0; i < index_s.size(); ++i) {
if (index_s == handle) {
Serial.println("found=");
Serial.println(handle);
Serial.println("----------------------");
pool.erase(pool.begin()+i);
index_s.erase(index_s.begin()+i);

    }
  }

}

就是把指针void *存储，然后设置一个数字和void *的关联表，把这个整数传递回去lua这边，lua代码
label1 = lv.label_create(btn)
label1就是存放一个从c返回的数字，这个数字是和void * 一一关联的
lv.label_create(btn) 这边就是创建标签，然后返回一个数字，这个数字就是label的身份证，之后的操作都得亮牌
比如 lv_attr.label_set_text(label1,"hello")

然后我们理解了lua和c的指针，数字身份关联就开始接触C和lua的对接层了
我们的给lua封装一个活动屏幕，让lua控件都往这边丢控件

static int l_scr_act(lua_State *L) {
// 1. 调用 LVGL 原生 API 获取当前活跃屏幕
lv_obj_t *act_scr = lv_scr_act();
if(act_scr == NULL) {
lua_pushinteger(L, 0); // 无活跃屏幕返回 0
return 1;
}

 int obj_h = alloc_handle(act_scr);
Serial.println("obj_h alloc_handle=");
Serial.println(obj_h);
// 3. 将屏幕句柄返回给 Lua，可存储到变量中
lua_pushnumber(L, obj_h);


return 1; // 返回 1 个值（句柄）

}
我先解释一下 lua要求C这的函数是必须有返回值，否则容易导致栈溢出芯片重启
lv_obj_t *act_scr = lv_scr_act();就是获取活动屏幕的指针地址
int obj_h = alloc_handle(act_scr); 就是把act_scr的地址，传递给pool，让pool分配一个数字标识，obj_h得到就是一个数字id身份
lua_pushnumber(L, obj_h); 就是把数字压回Lua的栈，返回给Lua
lua这边我们这样写就行了，即可获得活动屏幕
current_scr = lv.scr_act()
current_scr 这个就是活动屏幕，之后就可以对它进行操作了
记得放到lua的注册表 C代码

L就是你创建的虚拟机状态，记得虚拟机状态要统一不然容易注册到不知名的地方

lua_pushcfunction(L, l_scr_act);//注册C函数
lua_setfield(L, -2, "scr_act");//压到lua这边
lua_setglobal(L, "lv");//注册全局前缀 lv.xxxxxx

我们看看label怎么创建的
static int l_lv_label_create(lua_State* L)
{
lv_obj_t* parent = (lv_obj_t) get_ptr(lua_tointeger(L, 1));
lv_obj_t label = lv_label_create(parent);

int handle = alloc_handle(label);

lua_pushnumber(L,  handle);      // 返回整数给 Lua
return 1;

}
我解释一下
lv_obj_t* parent = (lv_obj_t) get_ptr(lua_tointeger(L, 1)); 为第一个参数获取活动屏幕的void内存地址保存到parent
lv_obj_t* label = lv_label_create(parent);往父对象(这里是活动屏幕)创建一个标签控件
int handle = alloc_handle(label); 这里是给label分配一个数字id，保存到handle
lua_pushnumber(L, handle); 再把数字id 压回去lua这边

记得注册
lua_pushcfunction(L, l_lv_label_create);
lua_setfield(L, -2, "label_create");
lua_setglobal(L, "lv");
我们看看lua这边怎么使用
current_scr = lv.scr_act()
label1 = lv.label_create(current_scr)
这样就可以创建完成了
你会发现现在屏幕啥显示都没有，哈哈哈，因为还没属性，后面开始
封装一个设置文本的
static int l_label_set_text(lua_State *L) {
Serial.println("label set text is begin");
// 1. 提取 Lua 传入的参数：标签句柄 + 文本字符串
int label_h = lua_tointeger(L, 1);
const char *text = lua_tostring(L, 2); // Lua 字符串

if(text == NULL){
     Serial.println("text == NULL");
}
Serial.println(text);
if(text == NULL) return 0;
// 3. 通过句柄获取 LVGL 标签对象
lv_obj_t *label = (lv_obj_t*) get_ptr(label_h);
if(label == NULL){
    Serial.println("label == NULL");
}
if(label == NULL) return 0;
// 4. 调用 LVGL 原生 API 设置文本
lv_label_set_text(label, text);
return 0; // 无返回值

}
看看重点
int label_h = lua_tointeger(L, 1); //获取控件的id 第一个参数
const char *text = lua_tostring(L, 2); // 获取从lua这边的参数文本内容
lv_obj_t label = (lv_obj_t) get_ptr(label_h); //查询label的句柄，返回内存地址到*label
lv_label_set_text(label, text); 设置文本
记得注册函数

我们看看lua这边怎么使用
current_scr = lv.scr_act()
label1 = lv.label_create(current_scr)
lv.set_label_text(label1,"我显示出来了")

由于没有设置参数，是默认的它位置是固定的我们还得封装一个位置函数我们看看怎么做

static int l_obj_set_pos(lua_State *L) {
int obj_h = lua_tointeger(L, 1);
int x = lua_tointeger(L, 2);
int y = lua_tointeger(L, 3);

Serial.println("l_obj_set_pos");
Serial.println(obj_h);
Serial.println("====================================");


lv_obj_t *obj = (lv_obj_t*)get_ptr(obj_h);
if(obj == NULL) {
    lua_pushinteger(L, 0);
    return 1;
}

lv_obj_set_pos(obj, x, y); // 直接调用 lv_obj_set_pos 同时设x/y
lua_pushinteger(L, obj_h); // 返回句柄，支持链式调用
return 1;

}

//这样就可以调整它的位置了，如果你认真学习，这边代码你可以看懂的
我们看看lua这边怎么写
current_scr = lv.scr_act()
label1 = lv.label_create(current_scr)
lv.set_label_text(label1,"我显示出来了")
lv.set_pos(label,20,100)

我们看看怎么封装，回调事件这些，我们以按钮的回调事件为例
local current_scr = lv_attr.scr_act()
btn = lv.btn_create(current_scr)
label1 = lv.label_create(btn)
lv.label_set_text(label1,"hello")
lv.obj_set_pos(btn,50,20)
lv.obj_set_size(btn,200,50)
lv.add_click(btn, "on_btn_click")

do
local count = 0 -- 局部变量，只在这个块里有效
function on_btn_click()
count = count + 1
lv.label_set_text(label1, "点击次数: " .. count)
end
end

lv.add_click(btn, "on_btn_click") 重点在这里 btn是控件id，on_btn_click是lua的函数名称
我们看看C这边怎么实现的
int l_add_click(lua_State *L)
{
// 1. 获取按钮
int btn_h = lua_tointeger(L, 1);
lv_obj_t btn = (lv_obj_t)get_ptr(btn_h);

// 2. 获取回调名字
const char *cb_name = lua_tostring(L, 2);

// 3. 复制字符串存到 user data（必须拷贝！）
char *store = (char*)malloc(strlen(cb_name) + 1);
strcpy(store, cb_name);
lv_obj_set_user_data(btn, store);

// 4. 绑定 LVGL 点击事件
lv_obj_add_event_cb(btn, btn_global_cb, LV_EVENT_CLICKED, NULL);

return 0;

}
lv_obj_set_user_data(btn, store); 重点是这里把lua这边函数名称存放到lvgl的userdata这边

void btn_global_cb(lv_event_t *e)
{
lv_obj_t *btn = lv_event_get_target(e);

// 取出函数名

const char cb_name = (const char)lv_obj_get_user_data(btn);
Serial.println("事件回调的东西");
Serial.println(cb_name);

if(!cb_name) return;

    lua_getglobal(LC, cb_name);
    if (!lua_isfunction(LC, -1)) {
        Serial.println("Lua中未定义该函数");
        lua_pop(LC, 1);
        return;
    }

    // 2. 调用Lua函数（0个参数，0个返回值）
    if (lua_pcall(LC, 0, 0, 0) != LUA_OK) {
        Serial.println("调用lua的callback失败：");
        Serial.println(lua_tostring(LC, -1));
        lua_pop(LC, 1);
    }

}

const char cb_name = (const char)lv_obj_get_user_data(btn); 从这里获取控件的user data因为控件存放的是从lua这边传递过来的lua函数名称
记得把 LC 换成自己的lua虚拟机状态名称
拿出来就可以调用了，之后的定时器lv_timer的封装思路也是一样

之后你也可以封装按键的group api我先给个demo你们参考

static int l_group_create(lua_State *L) {
lv_group_t *group = lv_group_create();
if (group == NULL) {
lua_pushinteger(L, 0);
return 1;
}

int group_h = alloc_handle(group);
lua_pushnumber(L, group_h);
return 1;

}

static int l_group_set_indev(lua_State *L) {
int group_h = lua_tointeger(L, 1);
lv_group_t group = (lv_group_t)get_ptr(group_h);
if (group == NULL) return 0;

if (indev_keypad != NULL) {
    lv_indev_set_group(indev_keypad, group);
}else{
     Serial.println("l_group_set_indev indev_keypad is null");
}
return 0;

}

static int l_group_add_obj(lua_State *L) {
int group_h = lua_tointeger(L, 1);
lv_group_t group = (lv_group_t)get_ptr(group_h);
if (group == NULL) return 0;

int obj_h = lua_tointeger(L, 2);
lv_obj_t *obj = (lv_obj_t*)get_ptr(obj_h);
if (obj == NULL) return 0;

lv_group_add_obj(group, obj);
return 0;

}

恭喜你成功入门lua和lvgl esp32相关的对接封装，我gitee有开源的lua运行环境开源代码和lvgl的对接代码
gitee.com/ccmmc
需要可以去clone
之后你可以尝试封装各种控件比如圆弧，按钮，复选框，日历这些组件，其实很多东西我都封装了，我不全量开源是因为防止白嫖党，伸手党，毕竟，授人以鱼不如授人以渔，跟着我的教程你可以做出了这些知识点，经验，实打实都是都是你自己的，毕竟后面都是重复劳动，靠着抄袭，只会让你思考能力降低，封装的话可以阅读官方文档比如你可以看中文文档https://lvgl.100ask.net/8.2/overview/style.html
里面有详细教程和api等等说明
写于2026-2-14 提前祝你们新年快乐，别卷了，新年就该好好玩玩
给你们看看我碰到的报错

Guru Meditation Error: Core 1 panic'ed (LoadProhibited).
Exception was unhandled.

Core 1 register dump:
PC : 0x
4005544b PS : 0x00060e30 A0 : 0x820026c4 A1 :
0x3fcedca0
A2 : 0x00000000 A3 : 0x3c0ff918 A4
: 0x00000008 A5 : 0x00000000
A6 : 0x3fcedca8 A7
: 0x3fca207c A8 : 0x3fca5e70 A9 : 0x3fcedc70

A10 : 0x00000018 A11 : 0x00000016 A12 : 0x000000
0a A13 : 0x00000013
A14 : 0x3fcedc88 A15 : 0xff
000000 SAR : 0x0000001e EXCCAUSE: 0x0000001c
EXCVADDR:
0x00000000 LBEG : 0x400556d5 LEND : 0x400556e5 LCOUNT
: 0xffffffff

Backtrace: 0x40055448:0x3fcedca0 0x420026c1:
0x3fcedcb0 0x420026dd:0x3fcedcd0 0x4202f1fc:0x3fcedcf0 0x4202f35
9:0x3fcedd20 0x4203a5c9:0x3fcedd40 0x4202f3a1:0x3fcedda0 0x4202f
3c1:0x3fceddc0 0x4202c2e9:0x3fcedde0 0x4202ed26:0x3fcede00 0x420
2f52e:0x3fcede80 0x4202cdec:0x3fcedeb0 0x4202afd9:0x3fcedef0 0x4
20040d6:0x3fcedf40 0x42043dd2:0x3fcee000