帮助与联系

如果你在使用 LVGLStudio 时遇到问题、有功能建议，或者想跟其他开发者交流，下面的方式都可以找到我们。

加入官方 QQ 群

最快的沟通渠道。群里会同步新版本发布、bug 修复、功能预告，也有很多 LVGL 开发者互相交流经验。

LVGLStudio 官方交流群 群号：493643707

反馈问题

提交问题前建议先做以下检查，可以节省彼此时间：

• 确认 LVGLStudio 已经更新到最新版本（前往下载页）
• 看一下编译器输出窗口里有没有报错信息，截图一起反馈会很有帮助
• 如果涉及特定代码片段无法运行，把 main.c 和编译宏（key=value 形式）一起附上

常见问题位置

• macOS 提示”无法打开 LVGLStudio，因为无法验证开发者”：见 主页常见问题
• 安装 / 编译 / 运行报错：建议把错误日志截图发到 QQ 群里，群里响应最快

AI 编程接口排障

AI 编程接口需要 v0.2.0 及以上版本，接入方法见 AI 编程。连不上时按下面顺序排查：

• 找不到 ~/.LVGLStudio/connection.md：这个文件在应用启动成功后才会生成。请确认 LVGLStudio 已经启动，且启动过程中没有被安全软件拦截。
• 返回 401：token 每次应用启动都会重新生成，旧 token 立即失效。每次调用前重新读一次 ~/.LVGLStudio/connection.md 即可。
• 连接直接被拒绝（ECONNREFUSED）：文件存在不代表服务还在跑 —— 应用可能已经退出。读文件里的 baseUrl 重新连接。
• 连接地址和文档里写的不一样：端口默认 8848，被占用时会自动往后顺延，一切以 connection.md 里写的地址为准。
• 调用成功但代码没变化：确认返回的是 success: true；失败时响应体里的 message 会写明下一步该做什么。
• 预览窗口整个冻住、状态一直是 unknown：程序运行到某一步后没能再出来，窗口不会再有反应。error 里会写明是”还没加载完”（等一下就好）还是”程序卡住了”（得改代码）。后者只能自己查 —— 先看日志最后几行确定程序停在哪一步。改完直接重新触发重跑。

反馈这类问题时，请把 connection.md 开头几行（version、baseUrl）一起附上，不要附上 token。

联系方式

期待在群里见到你 👋