LVGL最新安装教程（2025版）

LVGL（Light and Versatile Graphics Library）是一款开源的嵌入式图形库，专为微控制器和嵌入式系统设计。它提供了丰富的控件和样式，支持触摸屏输入，广泛应用于智能家居、工业控制等领域。本文将详细介绍如何在Windows和Ubuntu平台上安装和配置LVGL，帮助初学者快速上手。

一、准备工作

在开始安装之前，需要确保系统已安装以下工具：

• Git：用于克隆LVGL源码。
• CMake（3.10以上）：跨平台构建工具。
• 编译器：Windows推荐MinGW或Visual Studio；Ubuntu需安装gcc、g++等。
• SDL2：用于在PC上模拟运行LVGL（可选，但推荐）。

以下是针对不同平台的详细步骤。

二、Windows平台安装LVGL

Windows平台LVGL开发环境通常借助SDL2模拟器实现，无需硬件即可测试界面。

1. 安装依赖

下载并安装Git、CMake。从 SDL官网 下载SDL2-devel-2.30.x-mingw.zip（MinGW版）或VC版（Visual Studio）。解压到指定目录，例如 C:/SDL2。

2. 克隆LVGL模拟器项目

    git clone --recursive https://github.com/lvgl/lv_port_pc_eclipse.git  

此项目包含了LVGL源码及SDL模拟器支持。如果网络慢，可以先克隆主仓库再更新子模块。

3. 使用CMake配置并编译

打开CMake GUI，设置源码路径为克隆的文件夹，构建路径新建build目录。点击Configure，选择对应的编译器（MinGW Makefiles或Visual Studio）。如果SDL2未自动找到，手动设置SDL2_DIR为SDL2的cmake目录。然后点击Generate生成项目文件。最后打开终端进入build目录，执行mingw32-make或打开生成的.sln用VS编译。

4. 运行示例

编译完成后，在build目录下会生成可执行文件（如lvgl_sim.exe），双击运行即可看到LVGL演示界面。至此，Windows平台LVGL环境搭建完成。

三、Ubuntu平台安装LVGL

Ubuntu平台LVGL安装更为简便，通过包管理器安装依赖，然后编译模拟器。

1. 安装必要软件包

    sudo apt updatesudo apt install git build-essential cmake libsdl2-dev  

2. 克隆模拟器项目

    git clone --recursive https://github.com/lvgl/lv_port_pc_eclipse.git  

3. 编译

    cd lv_port_pc_eclipsemkdir build && cd buildcmake ..make -j$(nproc)  

4. 运行

    ./lvgl_sim  

此时会弹出一个窗口显示LVGL示例界面，说明Ubuntu平台LVGL环境配置成功。

四、常见问题

• SDL2找不到：确保路径正确，Windows需设置环境变量或CMake变量。
• 编译错误：检查CMake版本和编译器兼容性，建议使用较新版本。
• 模拟器窗口黑屏：可能是SDL2初始化失败，尝试更新显卡驱动或重新安装SDL2。

五、总结

本文提供了LVGL安装教程，覆盖Windows和Ubuntu两大平台。作为一款优秀的嵌入式图形库，LVGL能够帮助开发者快速构建美观的GUI。无论你是初学者还是资深开发者，都可以按照上述步骤搭建环境，开始你的图形界面开发之旅。希望这篇教程对你有所帮助！